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Introduction 



Welcome to the Red Hat Enterprise Linux System Administration Guide. 

The Red Hat Enterprise Linux System Administration Guide contains information on how to 
customize your Red Hat Enterprise Linux system to fit your needs. If you are looking for a 
step-by-step, task-oriented guide for configuring and customizing your system, this is the 
manual for you. This manual discusses many intermediate topics such as the following: 



• Setting up a network interface card (NIC) 

• Performing a Kickstart installation 

• Configuring Samba shares 

• Managing your software with RPM 

• Determining information about your system 

• Upgrading your kernel 

This manual is divided into the following main categories: 



• Installation-Related Reference 

• File Systems Reference 

• Package Management 

• Network Configuration 

• System Configuration 

• System Monitoring 

This guide assumes you have a basic understanding of your Red Hat Enterprise Linux system. 
If you need help installing Red Hat Enterprise Linux, refer to the Red Hat Enterprise Linux 
Installation Guide. For more general information about system administration, refer to the Red 
Hat Enterprise Linux Introduction to System Administration. If you need more advanced 
documentation such as an overview of file systems, refer to the Red Hat Enterprise Linux 
Reference Guide. If you need security information, refer to the Red Hat Enterprise Linux 
Security Guide. 

1. Changes To This Manual 

This manual has been reorganized for clarity and updated for the latest features of Red Hat 
Enterprise Linux 5.0.0. Some of the changes include: 
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Updated Kernel Modules and Manually Updating the Kernel Chapters 

The Kernel Modules and the Upgrading the Kernel Manual ly Chapters include Updated 

information in regards to the 2.6 kernel. Special thanks to Arjan van de Ven for his hard 
work in helping to complete this chapter. 

An Updated Network File System (NFS) Chapter 

The Network File System (NFS) chapter has been revised and reorganized to include 
NFSv4. Special thanks to Steve Dickson for his hard work in helping to complete this 
chapter. 

An Updated OProfile Chapter 

The OProfile chapter has been revised and reorganized to include updated information in 
regards to the 2.6 kernel. Special thanks to Will Cohen for his hard work in helping to 
complete this chapter. 

An Updated X Window System Chapter 

The X Window System chapter has been revised to include information on the X1 1 R6.8 
release developed by the X.Org team. 

Before reading this guide, you should be familiar with the contents of the Red Hat Enterprise 
Linux Installation Guide concerning installation issues, the Red Hat Enterprise Linux 
Introduction to System Administration for basic administration concepts, the Red Hat Enterprise 
Linux System Administration Guide for general customization instructions, and the Red Hat 
Enterprise Linux Security Guide tor security related instructions. This guide contains information 
about topics for advanced users. 

2. Document Conventions 

Certain words in this manual are represented in different fonts, styles, and weights. This 
highlighting indicates that the word is part of a specific category. The categories include the 
following: 



Courier font 

Courier font represents commands, file names and paths, and prompts . 



When shown as below, it indicates computer output: 



Desktop 


about . html 


logs 


paulwesterberg . png 


Mail 


backupf iles 


mail 


reports 



bold Courier font 

Bold Courier font represents text that you are to type, such as: service jonas start 
If you have to run a command as root, the root prompt (#) precedes the command: 
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# gconftool-2 



italic Courier font 

Italic Courier font represents a variable, such as an installation directory: 

install_di r/bin/ 

bold font 

Bold font represents application programs and text found on a graphical interface. 

When shown like this: OK , it indicates a button on a graphical application interface. 

Additionally, the manual uses different strategies to draw your attention to pieces of information. 
In order of how critical the information is to you, these items are marked as follows: 



Note 

A note is typically information that you need to understand the behavior of the 
system. 



A tip is typically an alternative way of performing a task. 



Important 

Important information is necessary, but possibly unexpected, such as a 
configuration change that will not persist after a reboot. 



Caution 

A caution indicates an act that would violate your support agreement, such as 
recompiling the kernel. 
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A 



Warning 

A warning indicates potential data loss, as may happen when tuning hardware 
for maximum performance. 



3. More to Come 

The Red Hat Enterprise Linux System Administration Guide is part of Red Hat's growing 
commitment to provide useful and timely support to Red Hat Enterprise Linux users. As new 
tools and applications are released, this guide will be expanded to include them. 

3.1. Send in Your Feedback 



If you find an error in the Red Hat Enterprise Linux System Administration Guide, or if you have 
thought of a way to make this manual better, we would love to hear from you! Please submit a 
report in Bugzilla (http://bugzilla.redhat.com/bugzilla/) against the component rh-sag. 

Be sure to mention the manual's identifier: 



rh-sag 



By mentioning this manual's identifier, we know exactly which version of the guide you have. 

If you have a suggestion for improving the documentation, try to be as specific as possible when 
describing it. If you have found an error, please include the section number and some of the 
surrounding text so we can find it easily. 



xviii 



Part I. Installation-Related 
Information 

The Red Hat Enterprise Linux Installation Guide discusses the installation of Red Hat Enterprise 
Linux and some basic post-installation troubleshooting. However, advanced installation options 
are covered in this manual. This part provides instructions for kickstart (an automated 
installation technique) and all related tools. Use this part in conjunction with the Red Hat 
Enterprise Linux Installation Guide to perform any of these advanced installation tasks. 



Chapter 1 . 



Kickstart Installations 

1. What are Kickstart Installations? 

Many system administrators would prefer to use an automated installation method to install Red 
Hat Enterprise Linux on their machines. To answer this need, Red Hat created the kickstart 
installation method. Using kickstart, a system administrator can create a single file containing 
the answers to all the questions that would normally be asked during a typical installation. 

Kickstart files can be kept on a single server system and read by individual computers during 
the installation. This installation method can support the use of a single kickstart file to install 
Red Hat Enterprise Linux on multiple machines, making it ideal for network and system 
administrators. 

Kickstart provides a way for users to automate a Red Hat Enterprise Linux installation. 

2. How Do You Perform a Kickstart Installation? 

Kickstart installations can be performed using a local CD-ROM, a local hard drive, or via NFS, 
FTP, or HTTP. 

To use kickstart, you must: 



1 . Create a kickstart file. 

2. Create a boot media with the kickstart file or make the kickstart file available on the network. 

3. Make the installation tree available. 

4. Start the kickstart installation. 

This chapter explains these steps in detail. 

3. Creating the Kickstart File 

The kickstart file is a simple text file, containing a list of items, each identified by a keyword. You 
can create it by editing a copy of the sample . ks file found in the rh-docs directory of the Red 
Hat Enterprise Linux Documentation CD, using the Kickstart Configurator application, or 
writing it from scratch. The Red Hat Enterprise Linux installation program also creates a sample 
kickstart file based on the options that you selected during installation. It is written to the file 
/root/anaconda-ks . cf g. You should be able to edit it with any text editor or word processor 
that can save files as ASCII text. 

First, be aware of the following issues when you are creating your kickstart file: 
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• Sections must be specified in order. Items within the sections do not have to be in a specific 
order unless otherwise specified. The section order is: 

• Command section — Refer to Section 4, "Kickstart Options" for a list of kickstart options. 
You must include the required options. 

• The %paokages section — Refer to Section 5, "Package Selection" 'for details. 

• The %pre and %post sections — These two sections can be in any order and are not 
required. Refer to Section 6, "Pre-installation Script" and Section 7, "Post-installation Script" 
for details. 

• Items that are not required can be omitted. 

• Omitting any required item results in the installation program prompting the user for an 
answer to the related item, just as the user would be prompted during a typical installation. 
Once the answer is given, the installation continues unattended (unless it finds another 
missing item). 

• Lines starting with a pound sign (#) are treated as comments and are ignored. 

• For kickstart upgrades, the following items are required: 

• Language 

• Language support 

• Installation method 

• Device specification (if device is needed to perform the installation) 

• Keyboard setup 

• The upgrade keyword 

• Boot loader configuration 

If any other items are specified for an upgrade, those items are ignored (note that this 
includes package selection). 

4. Kickstart Options 

The following options can be placed in a kickstart file. If you prefer to use a graphical interface 
for creating your kickstart file, use the Kickstart Configurator application. Refer to Chapter 2, 
Kickstart Configurator for details. 



Note 

If the option is followed by an equals mark (=), a value must be specified after it. 
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In the example commands, options in brackets ([]) are optional arguments for the 
command. 



autopart (optional) 

Automatically create partitions — 1 GB or more root (/) partition, a swap partition, and an 
appropriate boot partition for the architecture. One or more of the default partition sizes can 
be redefined with the part directive. 

ignoredisk (optional) 

Causes the installer to ignore the specified disks. This is useful if you use autopartition and 
want to be sure that some disks are ignored. For example, without ignoredisk, attempting 
to deploy on a SAN-cluster the kickstart would fail, as the installer detects passive paths to 
the SAN that return no partition table. 

The ignoredisk option is also useful if you have multiple paths to your disks. 
The syntax is: 



ignoredisk — drives=drivel, dri ve2, . . . 



Where dri veN is One Of sda, sdb,..., hda,... etc. 
autostep (optional) 

Similar to interactive except it goes to the next screen for you. It is used mostly for 
debugging. 

auth or authconf ig (required) 

Sets up the authentication options for the system. It is similar to the authconf ig command, 
which can be run after the install. By default, passwords are normally encrypted and are not 
shadowed. 

— enablemd5 

Use md5 encryption for user passwords. 

— enablenis 

Turns on NIS support. By default, —enablenis uses whatever domain it finds on the 
network. A domain should almost always be set by hand with the — nisdomain= option. 

— nisdomain= 

NIS domain name to use for NIS services. 
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— nisserver= 

Server to use for NIS services (broadcasts by default). 

— useshadow Or — enableshadow 

Use shadow passwords. 

— enableldap 

Turns on LDAP support in /etc/nsswitch.conf, allowing your system to retrieve 
information about users (UIDs, home directories, shells, etc.) from an LDAP directory. To 
use this option, you must install the nss_idap package. You must also specify a server and 
a base DN (distinguished name) with — idapserver= and — idapbasedn=. 

— enable ldapauth 

Use LDAP as an authentication method. This enables the pam_idap module for 
authentication and changing passwords, using an LDAP directory. To use this option, you 
must have the nss_idap package installed. You must also specify a server and a base DN 

with --ldapserver= and — ldapbasedn=. 
— ldapserver= 

If you specified either — enableldap or — enabieidapauth, use this option to specify the 
name of the LDAP server to use. This option is set in the /eto/idap . conf file. 

— ldapbasedn= 

If you specified either — enableldap or — enabieidapauth, use this option to specify the 
DN in your LDAP directory tree under which user information is stored. This option is set in 

the /etc/ldap . conf file. 
— enable ldapt Is 

Use TLS (Transport Layer Security) lookups. This option allows LDAP to send encrypted 
usernames and passwords to an LDAP server before authentication. 

— enablekrb5 

Use Kerberos 5 for authenticating users. Kerberos itself does not know about home 
directories, UIDs, or shells. If you enable Kerberos, you must make users' accounts known 
to this workstation by enabling LDAP, NIS, or Hesiod or by using the /usr/sbin/useradd 
command to make their accounts known to this workstation. If you use this option, you must 
have the pam_krb5 package installed. 

— krb5realm= 

The Kerberos 5 realm to which your workstation belongs. 

— krb5kdc= 

The KDC (or KDCs) that serve requests for the realm. If you have multiple KDCs in your 
realm, separate their names with commas (,). 

— krb 5 admins erver= 

The KDC in your realm that is also running kadmind. This server handles password 
changing and other administrative requests. This server must be run on the master KDC if 
you have more than one KDC. 
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— enablehesiod 

Enable Hesiod support for looking up user home directories, UIDs, and shells. More 
information on setting up and using Hesiod on your network is in 

/usr/ share/ do c/glibc-2 .x.x /readme. hesiod, which is included in the giibc package. 
Hesiod is an extension of DNS that uses DNS records to store information about users, 
groups, and various other items. 

--hesiodlhs 

The Hesiod LHS ("left-hand side") option, set in /etc/hesiod.conf. This option is used by 
the Hesiod library to determine the name to search DNS for when looking up information, 
similar to LDAP's use of a base DN. 

--hesiodrhs 

The Hesiod RHS ("right-hand side") option, set in /etc/hesiod.conf. This option is used 
by the Hesiod library to determine the name to search DNS for when looking up information, 
similar to LDAP's use of a base DN. 



Tip 

To look up user information for "jim", the Hesiod library looks up 
jim.passwd<LHS><RHS>, which should resolve to a TXT record that looks like 

What his paSSWd entry WOUld look like (jim: * : 501 : 501 : Jungle 

jim: /home/ jim: /bin/bash). For groups, the situation is identical, except 
jim.group<LHS><RHS> would be used. 

Looking up users and groups by number is handled by making "501. uid" a 
CNAME for "jim.passwd", and "501 .gid" a CNAME for "jim.group". Note that the 
LHS and RHS do not have periods . put in front of them when the library 
determines the name for which to search, so the LHS and RHS usually begin 
with periods. 



— enablesmbauth 

Enables authentication of users against an SMB server (typically a Samba or Windows 
server). SMB authentication support does not know about home directories, UIDs, or shells. 
If you enable SMB, you must make users' accounts known to the workstation by enabling 
LDAP, NIS, or Hesiod or by using the /usr/sbin/useradd command to make their 
accounts known to the workstation. To use this option, you must have the pam_smb package 
installed. 

— smbservers= 

The name of the server(s) to use for SMB authentication. To specify more than one server, 
separate the names with commas (,). 

— smbworkgroup= 

The name of the workgroup for the SMB servers. 
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— enablecache 

Enables the nscd service. The nscd service caches information about users, groups, and 
various other types of information. Caching is especially helpful if you choose to distribute 
information about users and groups over your network using NIS, LDAP, or hesiod. 

bootioader (required) 

Specifies how the GRUB boot loader should be installed. This option is required for both 
installations and upgrades. For upgrades, if GRUB is not the current boot loader, the boot 
loader is changed to GRUB. To preserve other boot loaders, use bootioader — upgrade. 

— append= 

Specifies kernel parameters. To specify multiple parameters, separate them with spaces. 
For example: 

bootioader — location=mbr — append="hdd=ide-scsi ide=nodma" 



— driveorder 

Specify which drive is first in the BIOS boot order. For example: 

bootioader — driveorder=sda, hda 



— location= 

Specifies where the boot record is written. Valid values are the following: mbr (the default), 
partition (installs the boot loader on the first sector of the partition containing the kernel), 
or none (do not install the boot loader). 

— password= 

Sets the GRUB boot loader password to the one specified with this option. This should be 
used to restrict access to the GRUB shell, where arbitrary kernel options can be passed. 

— md5pass= 

Similar to — password= except the password should already be encrypted. 

--upgrade 

Upgrade the existing boot loader configuration, preserving the old entries. This option is 
only available for upgrades. 

clearpart (optional) 

Removes partitions from the system, prior to creation of new partitions. By default, no 
partitions are removed. 



Note 

If the clearpart command is used, then the — onpart command cannot be 
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used on a logical partition. 



—all 

Erases all partitions from the system. 

— drives= 

Specifies which drives to clear partitions from. For example, the following clears all the 
partitions on the first two drives on the primary IDE controller: 

clearpart — drives=hda, hdb — all 
— initlabel 

Initializes the disk label to the default for your architecture (for example msdos for x86 and 
gpt for Itanium). It is useful so that the installation program does not ask if it should initialize 
the disk label if installing to a brand new hard drive. 

— linux 

Erases all Linux partitions. 

—none (default) 

Do not remove any partitions. 

cmdline (optional) 

Perform the installation in a completely non-interactive command line mode. Any prompts 
for interaction halts the install. This mode is useful on S/390 systems with the x3270 
console. 

device (optional) 

On most PCI systems, the installation program autoprobes for Ethernet and SCSI cards 
properly. On older systems and some PCI systems, however, kickstart needs a hint to find 
the proper devices. The device command, which tells the installation program to install 
extra modules, is in this format: 

device <type><moduleName> — opts=<options> 
<type> 

Replace with either scsi or eth 

<m o d u 1 e Nam e > 

Replace with the name of the kernel module which should be installed. 

— opts= 
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Options to pass to the kernel module. Note that multiple options may be passed if they are 
put in quotes. For example: 

— opts="aicl52x=0x340 io=ll" 
driverdisk (optional) 

Driver diskettes can be used during kickstart installations. You must copy the driver 
diskettes's contents to the root directory of a partition on the system's hard drive. Then you 
must use the driverdisk command to tell the installation program where to look for the 
driver disk. 

driverdisk <partition> [ — type=<f stype>] 

Alternatively, a network location can be specified for the driver diskette: 

driverdisk — source=f tp : / / path/ to/ dd . imgdriverdisk 

— source=http : / /path/ to/ dd . imgdriverdisk — source=nfs: host : /path/ to/ img 
<partition> 

Partition containing the driver disk. 

— type= 

File system type (for example, vfat or ext2). 

firewall (optional) 

This option corresponds to the Firewall Configuration screen in the installation program: 

firewall — enabled! — disabled [ — trust = ] <device> [ — port = ] 
— enabled 

Reject incoming connections that are not in response to outbound requests, such as DNS 
replies or DHCP requests. If access to services running on this machine is needed, you can 
choose to allow specific services through the firewall. 

--disabled 

Do not configure any iptables rules. 

— trust= 

Listing a device here, such as ethO, allows all traffic coming from that device to go through 
the firewall. To list more than one device, use — trust etho — trust ethi. Do NOT use 
a comma-separated format such as —trust etho, ethi. 
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<incoming> 

Replace with one or more of the following to allow the specified services through the 
firewall. 

• — ssh 

• --telnet 

• — smtp 

• — http 

• — ftp 

— port= 

You can specify that ports be allowed through the firewall using the port:protocol format. For 
example, to allow IMAP access through your firewall, specify imap : tcp. Numeric ports can 
also be specified explicitly; for example, to allow UDP packets on port 1234 through, specify 
1234 : udp. To specify multiple ports, separate them by commas. 

firstboot (optional) 

Determine whether the Setup Agent starts the first time the system is booted. If enabled, 
the firstboot package must be installed. If not specified, this option is disabled by default. 

— enable 

The Setup Agent is started the first time the system boots. 

--disable 

The Setup Agent is not started the first time the system boots. 

— reconf ig 

Enable the Setup Agent to start at boot time in reconfiguration mode. This mode enables 
the language, mouse, keyboard, root password, security level, time zone, and networking 
configuration options in addition to the default ones. 

halt (optional) 

Halt the system after the installation has successfully completed. This is similar to a manual 
installation, where anaconda displays a message and waits for the user to press a key 
before rebooting. During a kickstart installation, if no completion method is specified, the 
reboot option is used as default. 

The halt option is roughly equivalent to the shutdown -h command. 

For other completion methods, refer to the powerof f , reboot, and shutdown kickstart 
options. 

install (Optional) 

Tells the system to install a fresh system rather than upgrade an existing system. This is the 
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default mode. For installation, you must specify the type of installation from cdrom, 
harddrive, nf s, or uri (for FTP or HTTP installations). The install command and the 
installation method command must be on separate lines. 

cdrom 

Install from the first CD-ROM drive on the system. 

harddrive 

Install from a Red Hat installation tree on a local drive, which must be either vfat or ext2. 

• — partition= 

Partition to install from (such as, sdb2). 

• — dir= 

Directory containing the RedHat directory of the installation tree. 
For example: 

harddrive — partition=hdb2 — dir=/tmp/install-tree 
nf s 

Install from the NFS server specified. 

• — server= 

Server from which to install (hostname or IP). 

• — dir= 

Directory containing the RedHat directory of the installation tree. 
For example: 

nfs — server=nf sserver . example . com — dir=/tmp/install-tree 
url 

Install from an installation tree on a remote server via FTP or HTTP. 
For example: 

url — url http : / / <server>/ <dir> 

or: 
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url — url ftp :// <username> : <password>@<server>/ <dir> 
interactive (optional) 

Uses the information provided in the kickstart file during the installation, but allow for 
inspection and modification of the values given. You are presented with each screen of the 
installation program with the values from the kickstart file. Either accept the values by 
clicking Next or change the values and click Next to continue. Refer to the autostep 
command. 

keyboard (required) 

Sets system keyboard type. Here is the list of available keyboards on i386, Itanium, and 
Alpha machines: 

be-latinl, bg, br-abnt2, cf, cz-lat2, cz-us-qwertz, de, 
de-latinl, de-latinl-nodeadkeys , dk, dk-latinl, dvorak, es, et, 
fi, fi-latinl, fr, fr-latinO, fr-latinl, fr-pc, fr_CH, f r_CH-latinl , 
gr, hu, hulOl, is-latinl, it, it-ibm, it2, jpl06, la-latinl, mk-utf, 
no, no-latinl, pi, pt-latinl, ro_win, ru, ru-cpl251, ru-ms, rul, ru2, 
ru_win, se-latinl, sg, sg-latinl, sk-qwerty, Slovene, speakup, 
speakup-lt, sv-latinl, sg, sg-latinl, sk-querty, Slovene, trq, ua, 
uk, us, us-acentos 

The file /usr/lib/python2 . 2/site-packages/rhpl/keyboard_models .py also Contains 

this list and is part of the rhpi package, 
lang (required) 

Sets the language to use during installation. For example, to set the language to English, 
the kickstart file should contain the following line: 

lang en_US 

The file /usr/share/system-conf ig-language/locale-list provides a list Of the valid 

language codes in the first column of each line and is part of the system-conf ig-ianguage 
package. 

langsupport (required) 

Sets the language(s) to install on the system. The same language codes used with lang 
can be used with 1 angsupport. 

To install one language, specify it. For example, to install and use the French language 

f r_FR: 
langsupport fr_FR 
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— def ault= 

If language support for more than one language is specified, a default must be identified. 
For example, to install English and French and use English as the default language: 

langsupport — def ault=en_US fr_FR 

If you use — default with only one language, all languages are installed with the specified 
language set to the default. 

logvoi (optional) 

Create a logical volume for Logical Volume Management (LVM) with the syntax: 

logvol <mntpoint> — vgname= <name> — size=<size> — name=<name><options> 

The options are as follows: 
-noformat 

Use an existing logical volume and do not format it. 
-useexisting 

Use an existing logical volume and reformat it. 



Create the partition first, create the logical volume group, and then create the logical 
volume. For example: 



part pv . 01 


— size 3000 volgroup myvg pv.01 logvol / - 


— vgname=myvg 


— size=2000 


— name=rootvol 





For a detailed example of logvoi in action, refer to Section 4.1, "Advanced Partitioning 
Example". 

mouse (required) 

Configures the mouse for the system, both in GUI and text modes. Options are: 

— device= 

Device the mouse is on (such as — device=ttyso). 

— emulthree 

If present, simultaneous clicks on the left and right mouse buttons are recognized as the 
middle mouse button by the X Window System. This option should be used if you have a 
two button mouse. 

After options, the mouse type may be specified as one of the following: 
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alpsps/2, ascii, asciips/2, atibm, generic, generic3, genericps/2, 
generic3ps/2, genericwheelps/2, genericusb, generic3usb, genericwheelusb, 
geniusnm, geniusnmps/2 , geniusprops/2 , geniusscrollps/2 , geniusscrollps/2+, 
thinking, thinkingps/2, logitech, logitechcc, logibm, logimman, 
logimmanps/2 , logimman+, logimman+ps/2, logimmusb, microsoft, msnew, 
msintelli, msintellips/2, msintelliusb, msbm, mousesystems, mmseries, 
mmhittab, sun, none 

This list Can alSO be found in the /usr/lib/python2 . 2/site-packages/rhpl/mouse .py 

file, which is part of the rhpi package. 

If the mouse command is given without any arguments, or it is omitted, the installation 
program attempts to automatically detect the mouse. This procedure works for most modern 
mice. 

network (optional) 

Configures network information for the system. If the kickstart installation does not require 
networking (in other words, it is not installed over NFS, HTTP, or FTP), networking is not 
configured for the system. If the installation does require networking and network 
information is not provided in the kickstart file, the installation program assumes that the 
installation should be done over ethO via a dynamic IP address (BOOTP/DHCP), and 
configures the final, installed system to determine its IP address dynamically. The network 
option configures networking information for kickstart installations via a network as well as 
for the installed system. 

— bootproto= 

One Of dhcp, bootp, Or static. 

It defaults to dhcp. bootp and dhcp are treated the same. 

The DHCP method uses a DHCP server system to obtain its networking configuration. As 
you might guess, the BOOTP method is similar, requiring a BOOTP server to supply the 
networking configuration. To direct a system to use DHCP: 

network — bootproto=dhcp 

To direct a machine to use BOOTP to obtain its networking configuration, use the following 
line in the kickstart file: 

network — bootproto=bootp 

The static method requires that you enter all the required networking information in the 
kickstart file. As the name implies, this information is static and are used during and after 
the installation. The line for static networking is more complex, as you must include all 
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network configuration information on one line. You must specify the IP address, netmask, 
gateway, and nameserver. For example: (the "\" indicates that this should be read as one 
continuous line): 

network — bootproto=static — ip=10.0.2.15 — netmask=2 55 . 2 55 . 2 55 . \ 
— gateway=10 .0.2. 254 — nameserver=10 .0.2.1 

If you use the static method, be aware of the following two restrictions: 

• All static networking configuration information must be specified on one line; you cannot 
wrap lines using a backslash, for example. 

• You can only specify one nameserver here. However, you can use the kickstart file's 
%post section (described in Section 7, "Post-installation Script') to add more name 
servers, if needed. 

--device= 

Used to select a specific Ethernet device for installation. Note that using — device= is not 
effective unless the kickstart file is a local file (such as ks=f loppy), since the installation 
program configures the network to find the kickstart file. For example: 

network — bootproto=dhcp — device=ethO 
— ip= 

IP address for the machine to be installed. 

--gateway= 

Default gateway as an IP address. 

— nameserver= 

Primary nameserver, as an IP address. 

— nodns 

Do not configure any DNS server. 

— netmask= 

Netmask for the installed system. 

— hostnanie= 

Hostname for the installed system, 
part or partition (required for installs, ignored for upgrades) 
Creates a partition on the system. 

If more than one Red Hat Enterprise Linux installation exists on the system on different 
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partitions, the installation program prompts the user and asks which installation to upgrade. 



A 



Warning 

All partitions created are formatted as part of the installation process unless 

— noformat and — onpart are used. 



For a detailed example of part in action, refer to Section 4.1, "Advanced Partitioning 
Example". 

<mntpoint> 

The <mntpoint> is where the partition is mounted and must be of one of the following 
forms: 

• / <path> 

For example, /, /usr, /home 

• swap 

The partition is used as swap space. 

To determine the size of the swap partition automatically, use the —recommended option: 

swap — recommended 



The minimum size of the automatically-generated swap partition is no smaller than the 
amount of RAM in the system and no larger than twice the amount of RAM in the system. 

• raid . <id> 

The partition is used for software RAID (refer to raid). 

• pv . <id> 

The partition is used for LVM (refer to logvoi). 

— size= 

The minimum partition size in megabytes. Specify an integer value here such as 500. Do 
not append the number with MB. 

— grow 

Tells the partition to grow to fill available space (if any), or up to the maximum size setting. 

— maxsize= 

The maximum partition size in megabytes when the partition is set to grow. Specify an 
integer value here, and do not append the number with MB. 
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— noformat 

Tells the installation program not to format the partition, for use with the --onpart 
command. 

— onpart= Or — usepart= 

Put the partition on the already existing device. For example: 

partition /home — onpart=hdal 



puts /home on /dev/hdai, which must already exist. 

— ondisk= or — ondrive= 

Forces the partition to be created on a particular disk. For example, --ondisk=sdb puts the 
partition on the second SCSI disk on the system. 

--asprimary 

Forces automatic allocation of the partition as a primary partition, or the partitioning fails. 

— type= (replaced by f stype) 

This option is no longer available. Use f stype. 

— f stype= 

Sets the file system type for the partition. Valid values are ext2, ext3, swap, and vf at. 

— start= 

Specifies the starting cylinder for the partition. It requires that a drive be specified with 

— ondisk= or ondrive=. It also requires that the ending cylinder be specified with — end= or 

the partition size be specified with — size=. 

— end= 

Specifies the ending cylinder for the partition. It requires that the starting cylinder be 
specified with — start=. 



t Note 



If partitioning fails for any reason, diagnostic messages appear on virtual console 
3. 



powero f f (optional) 

Shut down and power off the system after the installation has successfully completed. 
Normally during a manual installation, anaconda displays a message and waits for the user 
to press a key before rebooting. During a kickstart installation, if no completion method is 
specified, the reboot option is used as default. 

The powerof f option is roughly equivalent to the shutdown -p command. 
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Note 

The powerof f option is highly dependent on the system hardware in use. 
Specifically, certain hardware components such as the BIOS, APM (advanced 
power management), and ACPI (advanced configuration and power interface) 
must be able to interact with the system kernel. Contact your manufacturer for 
more information on you system's APM/ACPI abilities. 



For other completion methods, refer to the halt, reboot, and shutdown kickstart options. 

raid (optional) 

Assembles a software RAID device. This command is of the form: 

raid <mntpoint> — level=<JeveJ> — devi.ce=<mddevice><partitions*> 
<mntpoint> 

Location where the RAID file system is mounted. If it is /, the RAID level must be 1 unless a 
boot partition (/boot) is present. If a boot partition is present, the /boot partition must be 
level 1 and the root (/) partition can be any of the available types. The <part±tions*> 
(which denotes that multiple partitions can be listed) lists the RAID identifiers to add to the 
RAID array. 

— level= 

RAID level to use (0, 1 , or 5). 

--device= 

Name of the RAID device to use (such as mdO or md1). RAID devices range from mdO to 
md7, and each may only be used once. 

— spares= 

Specifies the number of spare drives allocated for the RAID array. Spare drives are used to 
rebuild the array in case of drive failure. 

— f stype= 

Sets the file system type for the RAID array. Valid values are ext2, ext3, swap, and vfat. 

— noforraat 

Use an existing RAID device and do not format the RAID array. 

— useexi sting 

Use an existing RAID device and reformat it. 

The following example shows how to create a RAID level 1 partition for /, and a RAID level 
5 for /usr, assuming there are three SCSI disks on the system. It also creates three swap 
partitions, one on each drive. 
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part 


raid . 


.01 


— size=60 


— ondisk=sda 


part 


raid . 


.02 


--size=60 


— ondisk=sdb 


part 


raid . 


.03 


--size=60 


— ondisk=sdc 



part 


swap 


— size=128 


— ondisk=sda 


part 


swap 


— size=128 


--ondisk=sdb 


part 


swap 


— size=128 


— ondisk=sdc 



part 


raid . 


.11 


— size= 


1 


— grow 


— ondisk= 


sda 


part 


raid . 


. 12 


— size= 


1 


— grow 


— ondisk= 


sdb 


part 


raid . 


. 13 


— size= 


1 


— grow 


— ondisk= 


: sdc 



raid / — level=l — device=mdO raid. 01 raid. 02 raid. 03 
raid /usr — level=5 --device=mdl raid. 11 raid. 12 raid. 13 

For a detailed example of raid in action, refer to Section 4.1, "Advanced Partitioning 
Example". 

reboot (optional) 

Reboot after the installation is successfully completed (no arguments). Normally during a 
manual installation, anaconda displays a message and waits for the user to press a key 
before rebooting. 

The reboot option is roughly equivalent to the shutdown -r command. 



Note 

Use of the reboot option may result in an endless installation loop, depending 
on the installation media and method. 

The reboot option is the default completion method if no other methods are 
explicitly specified in the kickstart file. 



For other completion methods, refer to the halt, powerof f , and shutdown kickstart options, 
rootpw (required) 

Sets the system's root password to the < P assword> argument. 

rootpw [ — iscrypted] <password> 
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--iscrypted 

If this is present, the password argument is assumed to already be encrypted. 

selinux (optional) 

Sets the system's SELinux mode to one of the following arguments: 

— enforcing 

Enables SELinux with the default targeted policy being enforced. 



Note 

If the seiinux option is not present in the kickstart file, SELinux is enabled and 

Set to — enforcing by default. 



— permissive 

Outputs warnings only based on the SELinux policy, but does not actually enforce the 
policy. 

--disabled 

Disables SELinux completely on the system. 

For complete information regarding SELinux for Red Hat Enterprise Linux, refer to the Red 
Hat SELinux Guide. 

shutdown (optional) 

Shut down the system after the installation has successfully completed. During a kickstart 
installation, if no completion method is specified, the reboot option is used as default. 

The shutdown option is roughly equivalent to the shutdown command. 

For other completion methods, refer to the halt, powero f f , and reboot kickstart options, 
skipx (optional) 

If present, X is not configured on the installed system, 
text (optional) 

Perform the kickstart installation in text mode. Kickstart installations are performed in 
graphical mode by default. 

timezone (required) 

Sets the system time zone to <timezone> which may be any of the time zones listed by 

timeconf ig. 

timezone [ — utc] <timezone> 
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— utc 

If present, the system assumes the hardware clock is set to UTC (Greenwich Mean) time. 

upgrade (optional) 

Tells the system to upgrade an existing system rather than install a fresh system. You must 
specify one of cdrom, harddrive, nfs, or url (for FTP and HTTP) as the location of the 
installation tree. Refer to install for details. 

xconf ig (optional) 

Configures the X Window System. If this option is not given, the user must configure X 
manually during the installation, if X was installed; this option should not be used if X is not 
installed on the final system. 

— noprobe 

Do not probe the monitor. 

— card= 

Use specified card; this card name should be from the list of cards in 
/usr/share/hwdata/cards from the hwdata package. The list of cards can also be found 
on the X Configuration screen of the Kickstart Configurator. If this argument is not 
provided, the installation program probes the PCI bus for the card. Since AGP is part of the 
PCI bus, AGP cards are detected if supported. The probe order is determined by the PCI 
scan order of the motherboard. 

— videoram= 

Specifies the amount of video RAM the video card has. 

— monitor= 

Use specified monitor; monitor name should be from the list of monitors in 
/usr/share/hwdata/MonitorsDB from the hwdata package. The list of monitors can also 
be found on the X Configuration screen of the Kickstart Configurator. This is ignored if 
— hsync or — vsync is provided. If no monitor information is provided, the installation 
program tries to probe for it automatically. 

--hsync= 

Specifies the horizontal sync frequency of the monitor. 

— vsync= 

Specifies the vertical sync frequency of the monitor. 

— def aultdesktop= 

Specify either GNOME or KDE to set the default desktop (assumes that GNOME Desktop 
Environment and/or KDE Desktop Environment has been installed through %packages). 

— startxonboot 

Use a graphical login on the installed system. 

— resolution= 
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Specify the default resolution for the X Window System on the installed system. Valid 
values are 640x480, 800x600, 1024x768, 1152x864, 1280x1024, 1400x1050, 1600x1200. 
Be sure to specify a resolution that is compatible with the video card and monitor. 

— depth= 

Specify the default color depth for the X Window System on the installed system. Valid 
values are 8, 16, 24, and 32. Be sure to specify a color depth that is compatible with the 
video card and monitor. 

volgroup (optional) 

Use to create a Logical Volume Management (LVM) group with the syntax: 

volgroup <name><partition><options> 

The options are as follows: 
-noformat 

Use an existing volume group and do not format it. 
-useexisting 

Use an existing volume group and reformat it. 



Create the partition first, create the logical volume group, and then create the logical 
volume. For example: 



part pv . 01 


— size 3000 volgroup myvg pv.01 logvol / - 


— vgname=myvg 


— size=2000 


— name=rootvol 





For a detailed example of volgroup in action, refer to Section 4.1, "Advanced Partitioning 
Example". 

zerombr (optional) 

If zerombr is specified, and yes is its sole argument, any invalid partition tables found on 
disks are initialized. This destroys all of the contents of disks with invalid partition tables. 
This command should be in the following format: 

zerombr yes 

No other format is effective. 

%include 

Use the %inciude /path/to/ file command to include the contents of another file in the 
kickstart file as though the contents were at the location of the %inciude command in the 
kickstart file. 
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4.1. Advanced Partitioning Example 

The following is a single, integrated example showing the ciearpart, raid, part, voigroup, 
and logvoi kickstart options in action: 



ciearpart 


— d 


rives=hda, hdc — initlabel 








# Raid 1 IDE 


conf ig 










part 


raid . 


11 


— size 


1000 — asprimary — ondrive=hda 








part 


raid . 


12 


— size 


1000 — asprimary — ondrive=hda 








part 


raid . 


13 


— size 


2000 — asprimary — ondrive=hda 








part 


raid . 


14 


— size 


8000 --ondrive=hda 








part 


raid . 


15 


— size 


1 — grow — ondrive=hda 








part 


raid . 


21 


— size 


1000 — asprimary — ondrive=hdc 








part 


raid . 


22 


— size 


1000 — asprimary — ondrive=hdc 








part 


raid . 


23 


— size 


2000 — asprimary — ondrive=hdc 








part 


raid . 


24 


— size 


8000 — ondrive=hdc 








part 


raid . 


25 


— size 


1 — grow — ondrive=hdc 








# You 


i can 


add 


— spares= 


=x 








raid 


/ 




— fstype ext3 — device mdO — level=RAIDl raid. 


11 


raid 


.21 


raid 


/ safe 




— fstype ext3 — device mdl — level=RAIDl raid. 


12 


raid 


.22 


raid 


swap 




— fstype swap — device md2 — level=RAIDl raid. 


13 


raid 


.23 


raid 


/usr 




— fstype ext3 — device md3 — level=RAIDl raid. 


14 


raid 


.24 


raid 


pv. 01 




— fstype ext3 — device md4 — level=RAIDl raid. 


15 


raid 


.25 


# LVM configuration so 


that we can resize /var and /usr/local 


later 




voigroup sysvg pv.01 










logvoi /va 


r 




— vgname=sysvg — size=8000 — name 


=var 




logvoi /va 


r / f reespace 


— vgname=sysvg — size=8000 








— name=f ree space touse 










logvoi /us 


r/local 


— vgname=sysvg — size=l — grow — name 


=usrlocal 



This advanced example implements LVM over RAID, as well as the ability to resize various 
directories for future growth. 

5. Package Selection 

Use the %packages command to begin a kickstart file section that lists the packages you would 
like to install (this is for installations only, as package selection during upgrades is not 
supported). 

Packages can be specified by group or by individual package name. The installation program 
defines several groups that contain related packages. Refer to the RedHat/base/comps .xmi file 
on the first Red Hat Enterprise Linux CD-ROM for a list of groups. Each group has an id, user 
visibility value, name, description, and package list. In the package list, the packages marked as 
mandatory are always installed if the group is selected, the packages marked default are 
selected by default if the group is selected, and the packages marked optional must be 
specifically selected even if the group is selected to be installed. 
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In most cases, it is only necessary to list the desired groups and not individual packages. Note 
that the core and Base groups are always selected by default, so it is not necessary to specify 
them in the %packages section. 

Here is an example %packages selection: 

%packages @ X Window System @ GNOME Desktop Environment @ Graphical 
Internet @ Sound and Video dhcp 

As you can see, groups are specified, one to a line, starting with an @ symbol, a space, and then 
the full group name as given in the comps . xmi file. Groups can also be specified using the id for 
the group, such as gnome-desktop. Specify individual packages with no additional characters 
(the dhcp line in the example above is an individual package). 

You can also specify which packages not to install from the default package list: 

-autof s 

The following options are available for the %packages Option: 



— resolvedeps 

Install the listed packages and automatically resolve package dependencies. If this option is 
not specified and there are package dependencies, the automated installation pauses and 
prompts the user. For example: 



%packages — resolvedeps 
— ignoredeps 

Ignore the unresolved dependencies and install the listed packages without the 
dependencies. For example: 

%packages — ignoredeps 
— ignoremissing 

Ignore the missing packages and groups instead of halting the installation to ask if the 
installation should be aborted or continued. For example: 

%packages — ignoremissing 
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6. Pre-installation Script 

You can add commands to run on the system immediately after the ks . cf g has been parsed. 
This section must be at the end of the kickstart file (after the commands) and must start with the 
%pre command. You can access the network in the %pre section; however, name service has 
not been configured at this point, so only IP addresses work. 



Note 

Note that the pre-install script is not run in the change root environment. 



— interpreter /usr /bin/python 

Allows you to specify a different scripting language, such as Python. Replace 

/usr/bin/python with the scripting language of your choice. 

6.1. Example 

Here is an example %pre section: 



%pre 

#!/bin/sh 

hds="" 
mymedia=" " 

for file in /proc/ide/h* 
do 

mymedia= N cat $file/media* 
if [ $mymedia == "disk" ] ; then 
hds="$hds 1 basename $file~ " 

fi 
done 

set $hds 
numhd=*echo $#' 

drivel='echo $hds | cut -d' ' -fl~ 
drive2=~echo $hds | cut -d' ' -f2" 

#Write out partition scheme based on whether there are 1 or 2 hard drives 

if [ $numhd == "2" ] ; then 
#2 drives 

echo " #partitioning scheme generated in %pre for 2 drives" > 
/ tmp/part-include 

echo "clearpart — all" >> /tmp/part-include 

echo "part /boot — fstype ext3 — size 75 — ondisk hda" >> 
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/ tmp/part-include 

echo "part / — fstype ext3 — size 1 — grow — ondisk hda" >> 
/ tmp/part-include 

echo "part swap — recommended — ondisk $drivel" >> /tmp/part-include 
echo "part /home — fstype ext3 — size 1 — grow — ondisk hdb" >> 

/ tmp/part-include 

else 

#1 drive 

echo " #partitioning scheme generated in %pre for 1 drive" > 
/ tmp/part-include 

echo "clearpart — all" >> /tmp/part-include 

echo "part /boot — fstype ext3 — size 75" >> /tmp/part-includ 

echo "part swap — recommended" >> /tmp/part-include 

echo "part / — fstype ext3 — size 2048" >> /tmp/part-include 

echo "part /home — fstype ext3 — size 2048 — grow" >> /tmp/part-include 

fi 



This script determines the number of hard drives in the system and writes a text file with a 
different partitioning scheme depending on whether it has one or two drives. Instead of having a 
set of partitioning commands in the kickstart file, include the line: 

%include /tmp/part-include 



The partitioning commands selected in the script are used. 



Note 

The pre-installation script section of kickstart cannot manage multiple install trees 
or source media. This information must be included for each created ks.cfg file, 
as the pre-installation script occurs during the second stage of the installation 
process. 



7. Post-installation Script 

You have the option of adding commands to run on the system once the installation is 
complete. This section must be at the end of the kickstart file and must start with the %post 
command. This section is useful for functions such as installing additional software and 
configuring an additional nameserver. 




Note 



If you configured the network with static IP information, including a nameserver, 
you can access the network and resolve IP addresses in the %post section. If 
you configured the network for DHCP, the /etc/resoiv. conf file has not been 
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completed when the installation executes the %post section. You can access the 
network, but you can not resolve IP addresses. Thus, if you are using DHCP, you 
must specify IP addresses in the %post section. 



Note 

The post-install script is run in a chroot environment; therefore, performing tasks 
such as copying scripts or RPMs from the installation media do not work. 



— nochroot 

Allows you to specify commands that you would like to run outside of the chroot 
environment. 

The following example copies the file /etc/re solv . con f to the file system that was just 
installed. 



%post — nochroot 

cp /etc/resolv . conf /mnt / sysimage/etc/resolv . conf 



— interpreter /usr/bin/python 

Allows you to specify a different scripting language, such as Python. Replace 

/usr/bin/python with the scripting language of your choice. 

7.1. Examples 

Turn services on and off: 

/sbin/chkconf ig — level 345 telnet off / sbin/chkconf ig — level 345 finger 
off / sbin/chkconf ig — level 345 lpd off / sbin/chkconf ig — level 345 httpd on 



Run a script named runme from an NFS share: 

mkdir /mnt /temp mount -o nolock 10 . 1 . . 2 : /usr /new-machines /mnt /temp open 
-s -w — /mnt/temp/runme umount /mnt /temp 
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Note 

NFS file locking is not supported while in kickstart mode, therefore -o noiock is 
required when mounting an NFS mount. 



Add a user to the system: 

/usr/sbin/useradd bob /usr /bin/chf n -f "Bob Smith" bob /usr / sbin/usermod -p 
'kjdf$04930FTH/ ' bob 

8. Making the Kickstart File Available 

A kickstart file must be placed in one of the following locations: 



• On a boot diskette 

• On a boot CD-ROM 

• On a network 

Normally a kickstart file is copied to the boot diskette, or made available on the network. The 
network-based approach is most commonly used, as most kickstart installations tend to be 
performed on networked computers. 

Let us take a more in-depth look at where the kickstart file may be placed. 

8.1. Creating Kickstart Boot Media 

Diskette-based booting is no longer supported in Red Hat Enterprise Linux. Installations must 
use CD-ROM or flash memory products for booting. However, the kickstart file may still reside 
on a diskette's top-level directory, and must be named ks . cf g. 

To perform a CD-ROM-based kickstart installation, the kickstart file must be named ks . cf g and 
must be located in the boot CD-ROM's top-level directory. Since a CD-ROM is read-only, the file 
must be added to the directory used to create the image that is written to the CD-ROM. Refer to 
the Red Hat Enterprise Linux Installation Guide for instructions on creating boot media; 
however, before making the file .iso image file, copy the ks . cf g kickstart file to the 
isoiinux/ directory. 

To perform a pen-based flash memory kickstart installation, the kickstart file must be named 
ks . cf g and must be located in the flash memory's top-level directory. Create the boot image 
first, and then copy the ks . cf g file. 

For example, the following transfers a boot image to the pen drive (/dev/sda) using the dd 
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command: 

dd if =diskboot . img of=/dev/sda bs=lM 



Note 

Creation of USB flash memory pen drives for booting is possible, but is heavily 
dependent on system hardware BIOS settings. Refer to your hardware 
manufacturer to see if your system supports booting to alternate devices. 



8.2. Making the Kickstart File Available on the Network 

Network installations using kickstart are quite common, because system administrators can 
easily automate the installation on many networked computers quickly and painlessly. In 
general, the approach most commonly used is for the administrator to have both a 
BOOTP/DHCP server and an NFS server on the local network. The BOOTP/DHCP server is 
used to give the client system its networking information, while the actual files used during the 
installation are served by the NFS server. Often, these two servers run on the same physical 
machine, but they are not required to. 

To perform a network-based kickstart installation, you must have a BOOTP/DHCP server on 
your network, and it must include configuration information for the machine on which you are 
attempting to install Red Hat Enterprise Linux. The BOOTP/DHCP server provides the client 
with its networking information as well as the location of the kickstart file. 

If a kickstart file is specified by the BOOTP/DHCP server, the client system attempts an NFS 
mount of the file's path, and copies the specified file to the client, using it as the kickstart file. 
The exact settings required vary depending on the BOOTP/DHCP server you use. 

Here is an example of a line from the dhcpd . conf file for the DHCP server: 

filename " /us r /new-machine/ kickstart /" ; 
next-server blarg.redhat.com; 

Note that you should replace the value after filename with the name of the kickstart file (or the 
directory in which the kickstart file resides) and the value after next-server with the NFS 
server name. 

If the file name returned by the BOOTP/DHCP server ends with a slash ("/"), then it is 
interpreted as a path only. In this case, the client system mounts that path using NFS, and 
searches for a particular file. The file name the client searches for is: 

<ip-addr>-kickstart 
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The <ip-addr> section of the file name should be replaced with the client's IP address in dotted 
decimal notation. For example, the file name for a computer with an IP address of 10.10.0.1 

WOUld be 10.10.0. 1-kickstart. 

Note that if you do not specify a server name, then the client system attempts to use the server 
that answered the BOOTP/DHCP request as its NFS server. If you do not specify a path or file 
name, the client system tries to mount /kickstart from the BOOTP/DHCP server and tries to 
find the kickstart file using the same <ip-addr>-kickstart file name as described above. 

9. Making the Installation Tree Available 

The kickstart installation must access an installation tree. An installation tree is a copy of the 
binary Red Hat Enterprise Linux CD-ROMs with the same directory structure. 

If you are performing a CD-based installation, insert the Red Hat Enterprise Linux CD-ROM #1 
into the computer before starting the kickstart installation. 

If you are performing a hard drive installation, make sure the ISO images of the binary Red Hat 
Enterprise Linux CD-ROMs are on a hard drive in the computer. 

If you are performing a network-based (NFS, FTP, or HTTP) installation, you must make the 
installation tree available over the network. Refer to the Preparing for a Network Installation 
section of the Red Hat Enterprise Linux Installation Guide for details. 

10. Starting a Kickstart Installation 

To begin a kickstart installation, you must boot the system from boot media you have made or 
the Red Hat Enterprise Linux CD-ROM #1 , and enter a special boot command at the boot 
prompt. The installation program looks for a kickstart file if the ks command line argument is 
passed to the kernel. 



CD-ROM #1 and Diskette 

The linux ks=f loppy command also works if the ks . cf g file is located on a vfat or ext2 
file system on a diskette and you boot from the Red Hat Enterprise Linux CD-ROM #1 . 

An alternate boot command is to boot off the Red Hat Enterprise Linux CD-ROM #1 and 
have the kickstart file on a vfat or ext2 file system on a diskette. To do so, enter the 
following command at the boot : prompt: 

linux ks=hd: fdO : /ks . cfg 



With Driver Disk 

If you need to use a driver disk with kickstart, specify the dd option as well. For example, to 



31 



Chapter 1. Kickstart Installa.. 



boot off a boot diskette and use a driver disk, enter the following command at the boot : 
prompt: 

linux ks=floppy dd 
Boot CD-ROM 

If the kickstart file is on a boot CD-ROM as described in Section 8. 1, "Creating Kickstart 
Boot Media", insert the CD-ROM into the system, boot the system, and enter the following 
command at the boot : prompt (where ks . cf g is the name of the kickstart file): 

linux ks=cdrom : /ks . cf g 

Other options to start a kickstart installation are as follows: 



ks=nf s : <server> : / <path> 

The installation program looks for the kickstart file on the NFS server <server>, as file 
<path>. The installation program uses DHCP to configure the Ethernet card. For example, if 
your NFS server is server.example.com and the kickstart file is in the NFS share 
/mydir/ks . cf g, the correct boot command would be 

ks=nf s : server . example . com : /mydir/ks . cf g. 
ks=http : / / <server> / <path> 

The installation program looks for the kickstart file on the HTTP server <server>, as file 
<path>. The installation program uses DHCP to configure the Ethernet card. For example, if 
your HTTP server is server.example.com and the kickstart file is in the HTTP directory 
/mydir/ks . cf g, the correct boot command would be 

ks=http : / / server . example . com/my dir /ks . cf g. 
ks=f loppy 

The installation program looks for the file ks . cf g on a vfat or ext2 file system on the 
diskette in /dev/fdo. 

ks=f loppy : / <path> 

The installation program looks for the kickstart file on the diskette in /dev/fdo, as file 

<path>. 
ks=hd : <device> : / <file> 

The installation program mounts the file system on <device> (which must be vfat or ext2), 
and look for the kickstart configuration file as <fiie> in that file system (for example, 

ks=hd: sda3 : /mydir/ks . cf g). 
ks=f ile : / <file> 

The installation program tries to read the file <fiie> from the file system; no mounts are 
done. This is normally used if the kickstart file is already on the initrd image. 
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ks=cdrom: / <path> 

The installation program looks for the kickstart file on CD-ROM, as file <path>. 

ks 

If ks is used alone, the installation program configures the Ethernet card to use DHCP. The 
kickstart file is read from the "bootServer" from the DHCP response as if it is an NFS server 
sharing the kickstart file. By default, the bootServer is the same as the DHCP server. The 
name of the kickstart file is one of the following: 

• If DHCP is specified and the boot file begins with a /, the boot file provided by DHCP is 
looked for on the NFS server. 

• If DHCP is specified and the boot file begins with something other then a /, the boot file 
provided by DHCP is looked for in the /kickstart directory on the NFS server. 

• If DHCP did not specify a boot file, then the installation program tries to read the file 

/kickstart /i .2 . 3 . 4 -kickstart, where i .2. 3. 4 is the numeric IP address of the 
machine being installed. 

ksdevice=<device> 

The installation program uses this network device to connect to the network. For example, 
to start a kickstart installation with the kickstart file on an NFS server that is connected to 
the system through the eth1 device, use the command ks=nf s : <server>-. / <path> 

ksdevice=ethl at the boot: prompt. 
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Kickstart Configurator 

Kickstart Configurator allows you to create or modify a kickstart file using a graphical user 
interface, so that you do not have to remember the correct syntax of the file. 

To use Kickstart Configurator, you must be running the X Window System. To start Kickstart 
Configurator, select Applications (the main menu on the panel) => System Tools => 

Kickstart, Or type the Command /usr/sbin/system-conf ig-kickstart. 

As you are creating a kickstart file, you can select File => Preview at any time to review your 
current selections. 

To start with an existing kickstart file, select File => Open and select the existing file. 

1. Basic Configuration 



File Help 



3asic Configuration 



Installation Method 
Boot Loader Options 
Partition Information 
Network Configuration 
Authentication 
Firewall Configuration 
Display Configuration 
Package Selection 
Pre-lnstallation Script 
Post-Installation Script 



Basic Configuration (required) 



Default Language: English (USA) 
Keyboard: 



U.S. English 



Mouse: 



Time Zone: 



Generic - Wheel Mouse (PS/2) 



□ Emulate 3 Buttons 



America/New_York 



□ Use UTC clock 



Root Password: 
Confirm Password: 

Language Support: 



Encrypt root password 



Q Lao (Laos) 
Q Latvian (Latvia) 



E2 Lithuanian 



r 



Target Architecture: 



x8S, AMD64, or Intel EM64T 



Reboot system after installation 

□ Perform installation in text mode (graphical is default) 

D Perform installation in interactive mode 



Figure 2.1. Basic Configuration 
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Choose the language to use during the installation and as the default language to be used after 
installation from the Default Language menu. 

Select the system keyboard type from the Keyboard menu. 

Choose the mouse for the system from the Mouse menu. If No Mouse is selected, no mouse is 
configured. If Probe for Mouse is selected, the installation program tries to automatically detect 
the mouse. Probing works for most modern mice. 

If the system has a two-button mouse, a three-button mouse can be emulated by selecting 
Emulate 3 Buttons. If this option is selected, simultaneously clicking the left and right mouse 
buttons are recognized as a middle mouse button click. 

From the Time Zone menu, choose the time zone to use for the system. To configure the 
system to use UTC, select Use UTC clock. 

Enter the desired root password for the system in the Root Password text entry box. Type the 
same password in the Confirm Password text box. The second field is to make sure you do not 
mistype the password and then realize you do not know what it is after you have completed the 
installation. To save the password as an encrypted password in the file, select Encrypt root 
password. If the encryption option is selected, when the file is saved, the plain text password 
that you typed are encrypted and written to the kickstart file. Do not type an already encrypted 
password and select to encrypt it. Because a kickstart file is a plain text file that can be easily 
read, it is recommended that an encrypted password be used. 

To install languages in addition to the one selected from the Default Language pulldown menu, 
check them in the Language Support list. The language selected from the Default Language 

pulldown menu is used by default after installation; however, the default can be changed with 
the Language Configuration Tool (system-conf ig-ianguage) after installation. 

Choosing Target Architecture specifies which specific hardware architecture distribution is 
used during installation. 

Choosing Reboot system after installation reboots your system automatically after the 
installation is finished. 

Kickstart installations are performed in graphical mode by default. To override this default and 
use text mode instead, select the Perform installation in text mode option. 

You can perform a kickstart installation in interactive mode. This means that the installation 
program uses all the options pre-configured in the kickstart file, but it allows you to preview the 
options in each screen before continuing to the next screen. To continue to the next screen, 
click the Next button after you have approved the settings or change them before continuing the 
installation. To select this type of installation, select the Perform installation in interactive 
mode option. 

2. Installation Method 
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Eile Help 






Basic Configuration 




Installation Method (required) 




1 Installation Method 




® Perform new installation 




Boot Loader Options 




O Upgrade an existing installation 




Partition Information 




Choose the Installation Method: 




Network Configuration 




® CD-ROM 




Authentication 




O NFS 




Firewall Configuration 




O FTP 




Display Configuration 




O HTTP 




Package Selection 




O Hard Drive 




Pre-I installation Script 








Post-Installation Script 













Figure 2.2. Installation Method 



The Installation Method screen allows you to choose whether to perform a new installation or 
an upgrade. If you choose upgrade, the Partition Information and Package Selection options 
are disabled. They are not supported for kickstart upgrades. 

Choose the type of kickstart installation or upgrade screen from the following options: 



• CD-ROM — Choose this option to install or upgrade from the Red Hat Enterprise Linux 
CD-ROMs. 

• NFS — Choose this option to install or upgrade from an NFS shared directory. In the text field 
for the the NFS server, enter a fully-qualified domain name or IP address. For the NFS 
directory, enter the name of the NFS directory that contains the RedHat directory of the 
installation tree. For example, if the NFS server contains the directory 

/mirrors/redhat/i386/RedHat/, enter /mirrors/redhat/i386/ for the NFS directory. 
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• FTP — Choose this option to install or upgrade from an FTP server. In the FTP server text 
field, enter a fully-qualified domain name or IP address. For the FTP directory, enter the name 
of the FTP directory that contains the RedHat directory. For example, if the FTP server 

Contains the directory /mirrors/redhat/i386/RedHat/, enter /mirrors/redhat/i386/ for 

the FTP directory. If the FTP server requires a username and password, specify them as well. 

• HTTP — Choose this option to install or upgrade from an HTTP server. In the text field for the 
HTTP server, enter the fully-qualified domain name or IP address. For the HTTP directory, 
enter the name of the HTTP directory that contains the RedHat directory. For example, if the 
HTTP server contains the directory /mirrors/redhat/i386/RedHat/, enter 

/mirrors /redhat/i386/ for the HTTP directory. 

• Hard Drive — Choose this option to install or upgrade from a hard drive. Hard drive 
installations require the use of ISO (or CD-ROM) images. Be sure to verify that the ISO 
images are intact before you start the installation. To verify them, use an md5sum program as 
well as the linux mediacheck boot option as discussed in the Red Hat Enterprise Linux 
Installation Guide. Enter the hard drive partition that contains the ISO images (for example, 
/dev/hdai) in the Hard Drive Partition text box. Enter the directory that contains the ISO 
images in the Hard Drive Directory text box. 

3. Boot Loader Options 
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File Help 

Basic Configuration 
Installation Method 



Soot Loader Options 



Partition Information 
Network Configuration 
Authentication 
Firewall Configuration 
Display Configuration 
Package Selection 
Pre-lnstallation Script 
Post-Installation Script 



Boot Loader Options (required) 
® Install new boot loader 
O Do not install a boot loader 
O Upgrade existing boot loader 

GRUB Options: 

□ Use GRUB password 



Password: 
Confirm Password: 



D Encrypt GRUB password 

® Install boot loader on Master Boot Record (MBR) 
O Install boot loader on first sector of the boot partition 



Kernel parameters: 



Figure 2.3. Boot Loader Options 



GRUB is the default boot loader for Red Hat Enterprise Linux. If you do not want to install a boot 
loader, select Do not install a boot loader. If you choose not to install a boot loader, make 
sure you create a boot diskette or have another way to boot your system, such as a third-party 
boot loader. 

You must choose where to install the boot loader (the Master Boot Record or the first sector of 
the /boot partition). Install the boot loader on the MBR if you plan to use it as your boot loader. 

To pass any special parameters to the kernel to be used when the system boots, enter them in 
the Kernel parameters text field. For example, if you have an IDE CD-ROM Writer, you can tell 
the kernel to use the SCSI emulation driver that must be loaded before using odreoord by 
configuring hdd=ide-scsi as a kernel parameter (where hdd is the CD-ROM device). 

You can password protect the GRUB boot loader by configuring a GRUB password. Select Use 
GRUB password, and enter a password in the Password field. Type the same password in the 
Confirm Password text field. To save the password as an encrypted password in the file, 
select Encrypt GRUB password. If the encryption option is selected, when the file is saved, the 
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plain text password that you typed are encrypted and written to the kickstart file. If type an 
already encrypted password, unselect to encrypt it. 

If Upgrade an existing installation is selected on the Installation Method page, select 
Upgrade existing boot loader to upgrade the existing boot loader configuration, while 
preserving the old entries. 

4. Partition Information 



File Help 



Basic Configuration 
Installation Method 
Boot Loader Options 



Partition Information 



Network Configuration 
Authentication 
Firewall Configuration 
Display Configuration 
Package Selection 
Pre-lnstallation Script 
Post-Installation Script 



Partition Information (required) 
® Clear Master Boot Record 
O Do not clear Master Boot Record 

® Remove all existing partitions 
O Remove existing Linux partitions 
O Preserve existing partitions 

® Initialize the disk label 

O Do not initialize the disk label 



Device/ 

Partition Number 


Mount Point/ 
RAID 


Type 


Format 


Size (MB) 



Add 


Edit 


Delete 


RAID 



Figure 2.4. Partition Information 



Select whether or not to clear the Master Boot Record (MBR). Choose to remove all existing 
partitions, remove all existing Linux partitions, or preserve existing partitions. 

To initialize the disk label to the default for the architecture of the system (for example, msdos 
for x86 and gpt for Itanium), select Initialize the disk label if you are installing on a brand new 
hard drive. 

4.1. Creating Partitions 
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To create a partition, click the Add button. The Partition Options window shown in Figure 2.5, 
"Creating Partitions" appears. Choose the mount point, file system type, and partition size for 
the new partition. Optionally, you can also choose from the following: 

• In the Additional Size Options section, choose to make the partition a fixed size, up to a 
chosen size, or fill the remaining space on the hard drive. If you selected swap as the file 
system type, you can select to have the installation program create the swap partition with the 
recommended size instead of specifying a size. 

• Force the partition to be created as a primary partition. 

• Create the partition on a specific hard drive. For example, to make the partition on the first 
IDE hard disk (/dev/hda), specify hda as the drive. Do not include /dev in the drive name. 

• Use an existing partition. For example, to make the partition on the first partition on the first 
IDE hard disk (/dev/hdai), specify hdai as the partition. Do not include /dev in the partition 
name. 

• Format the partition as the chosen file system type. 
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Mount Point: 



ext3 



File System Type: 

Size (MB): 
Additional Size Options 

® Fixed size 

O Grow to maximum of (MB): 
Cj Fill all unused space on disk 
O Use recommended swap size 



O Force to be a primary partition (as primary) 

D Make partition on specific drive (ondisk) 

Drive : (for example: hda or sdc) 



O Use existing partition (onpart) 
Partition 



(for example: hdal or sdc3) 



[7] Format partition 



£g Cancel 



<^OK 



Figure 2.5. Creating Partitions 



To edit an existing partition, select the partition from the list and click the Edit button. The same 
Partition Options window appears as when you chose to add a partition as shown in 
Figure 2.5, "Creating Partitions", except it reflects the values for the selected partition. Modify 
the partition options and click OK. 

To delete an existing partition, select the partition from the list and click the Delete button. 

4.1.1. Creating Software RAID Partitions 

To create a software RAID partition, use the following steps: 
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1. Click the RAID button. 

2. Select Create a software RAID partition. 

3. Configure the partitions as previously described, except select Software RAID as the file 
system type. Also, you must specify a hard drive on which to make the partition or specify an 
existing partition to use. 



Mount Point: 



File System Type: 



Size (MB): 



software RAID 



2C43 



Additional Size Options 
® Fixed size 

O Grow to maximum of (MB): 
O Fill all unused space on disk 

O Use recommended swap size 



O Force to be a primary partition fas primary) 

[7] Make partition on specific drive (ondisk) 

(for example: hda or sdc) 



Drive : sda 



O Use existing partition (on part) 
Partition 



(for example: hdal or sdc3) 



[7] Format partition 



% Cancel 



<^OK 



Figure 2.6. Creating a Software RAID Partition 



Repeat these steps to create as many partitions as needed for your RAID setup. All of your 
partitions do not have to be RAID partitions. 



After creating all the partitions needed to form a RAID device, follow these steps: 
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1. Click the RAID button. 

2. Select Create a RAID device. 

3. Select a mount point, file system type, RAID device name, RAID level, RAID members, 
number of spares for the software RAID device, and whether to format the RAID device. 



Mount Point: 
File System Type: 
RAID Device: 
RAID Level: 

Raid Members 
Number of spares: 



/home 



ext3 



rndO 







raid. 01 



E3 raid. 02 



Format RAID device 



2£ Cancel 



<90K 



Figure 2.7. Creating a Software RAID Device 



4. Click OK to add the device to the list. 



5. Network Configuration 
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Authentication 



File Help 

Basic Configuration 
Installation Method 
Boot Loader Options 
Partition Information 



Network Configuration 



Authentication 
Firewall Configuration 
Display Configuration 
Package Selection 
Pre-lnstallation Script 
Post-Installation Script 



Network Configuration 



Device Network Type 



Add Network Device 



Edit Network Device 



Delete Network Device 



Figure 2.8. Network Configuration 



If the system to be installed via kickstart does not have an Ethernet card, do not configure one 
on the Network Configuration page. 

Networking is only required if you choose a networking-based installation method (NFS, FTP, or 
HTTP). Networking can always be configured after installation with the Network 
Administration Tool (system-conf ig-network). Refer to Chapter 17, Network Configuration 
for details. 

For each Ethernet card on the system, click Add Network Device and select the network 
device and network type for the device. Select ethO to configure the first Ethernet card, eth1 for 
the second Ethernet card, and so on. 

6. Authentication 
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File Help 

Basic Configuration 
Installation Method 
Boot Loader Options 
Partition Information 
Network Configuration 



Authentication 



Firewall Configuration 
Display Configuration 
Package Selection 
Pre-lnstallation Script 
Post-Installation Script 



Authentication Configuration — 

Authentication: Use Shadow Passwords 0UseMD5 



NIS LDAP Kerberos 5 Hesiod SMB Name Switch Cache 



NIS Authentication 
□ Enable NIS 



NIS Domain: 



□ Use broadcast to find NIS server 
NIS Server: 



Figure 2.9. Authentication 



In the Authentication section, select whether to use shadow passwords and MD5 encryption 
for user passwords. These options are highly recommended and chosen by default. 

The Authentication Configuration options allow you to configure the following methods of 
authentication: 

• NIS 

• LDAP 

• Kerberos 5 

• Hesiod 

• SMB 
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• Name Switch Cache 

These methods are not enabled by default. To enable one or more of these methods, click the 
appropriate tab, click the checkbox next to Enable, and enter the appropriate information for the 
authentication method. Refer to Chapter 26, Authentication Configuration tor more information 
about the options. 

7. Firewall Configuration 

The Firewall Configuration window is similar to the screen in the installation program and the 
Security Level Configuration Tool. 



Eile Help 

Basic Configuration 
Installation Method 
Boot Loader Options 
Partition Information 
Network Configuration 
Authentication 



Firewall Configuration 



Display Configuration 
Package Selection 
Pre-lnstallation Script 
Post-Installation Script 



Figure 2.10. Firewall Configuration 

If Disable firewall is selected, the system allows complete access to any active services and 
ports. No connections to the system are refused or denied. 

Selecting Enable firewall configures the system to reject incoming connections that are not in 



Firewall Configuration 
Security level 



Enable firewall 



Trusted devices: 



Trusted services: 



□ WWW (HTTP) 

□ FTP 

□ SSH 

□ Telnet 

□ Mail (SMTP) 



Other ports: (1029:tcp) 
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response to outbound requests, such as DNS replies or DHCP requests. If access to services 
running on this machine is required, you can choose to allow specific services through the 
firewall. 

Only devices configured in the Network Configuration section are listed as available Trusted 
devices. Connections from any devices selected in the list are accepted by the system. For 
example, if eth1 only receives connections from internal system, you might want to allow 
connections from it. 

If a service is selected in the Trusted services list, connections for the service are accepted 
and processed by the system. 

In the Other ports text field, list any additional ports that should be opened for remote access. 
Use the following format: port: protocol. For example, to allow IMAP access through the 
firewall, specify imap:tcp. Specify numeric ports can also be specified; to allow UDP packets 
on port 1 234 through the firewall, enter 1234 : udp. To specify multiple ports, separate them with 
commas. 

7.1. SELinux Configuration 

Although configuration for SELinux is not specified in the Kickstart Configurator, kickstart 
enables SELinux in enforcing mode by default if the seiinux parameter is omitted from the 
kickstart file. 

8. Display Configuration 

If you are installing the X Window System, you can configure it during the kickstart installation 
by checking the Configure the X Window System option on the Display Configuration 

window as shown in Figure 2. 1 1, "X Configuration - General". If this option is not chosen, the X 
configuration options are disabled and the skipx option is written to the kickstart file. 

8.1. General 

The first step in configuring X is to choose the default color depth and resolution. Select them 
from their respective pulldown menus. Be sure to specify a color depth and resolution that is 
compatible with the video card and monitor for the system. 
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File Help 

Basic Configuration 
Installation Method 
Boot Loader Options 
Partition Information 
Network Configuration 
Authentication 
Firewall Configuration 



Display Configuration 



Package Selection 
Pre-lnstallation Script 
Post-Installation Script 



Display Configuration 

HjConfigure the X Window System; 



General 



Video Card 



Monitor 



Color Depth 



Resolution 



8 



640x480 



Default Desktop: © GNOME O KDE 

□ Start the X Window System on boot 
On first boot, Setup Agent is: Disabled 



Figure 2.11. X Configuration - General 



If you are installing both the GNOME and KDE desktops, you must choose which desktop 
should be the default. If only one desktop is to be installed, be sure to choose it. Once the 
system is installed, users can choose which desktop they want to be their default. 

Next, choose whether to start the X Window System when the system is booted. This option 
starts the system in runlevel 5 with the graphical login screen. After the system is installed, this 
can be changed by modifying the /etc/inittab configuration file. 

Also select whether to start the Setup Agent the first time the system is rebooted. It is disabled 
by default, but the setting can be changed to enabled or enabled in reconfiguration mode. 
Reconfiguration mode enables the language, mouse, keyboard, root password, security level, 
time zone, and networking configuration options in addition to the default ones. 

8.2. Video Card 

Probe for video card is selected by default. Accept this default to have the installation program 
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probe for the video card during installation. Probing works for most modern video cards. If this 
option is selected and the installation program cannot successfully probe the video card, the 
installation program stops at the video card configuration screen. To continue the installation 
process, select your video card from the list and click Next. 

Alternatively, you can select the video card from the list on the Video Card tab as shown in 
Figure 2. 12, "X Configuration - Video Card". Specify the amount of video RAM the selected 
video card has from the Video Card RAM pulldown menu. These values are used by the 
installation program to configure the X Window System. 



File Help 



Basic Configuration 
Installation Method 
Boot Loader Options 
Partition Information 
Network Configuration 
Authentication 
Firewall Configuration 



Display Configuration 



Package Selection 
Pre-lnstallation Script 
Post-Installation Script 



Display Configuration 

Configure the X Window System 



General 



Video Card 



Monitor 



□ Probe for video card 



Matrox Comet 
Matrox Marvel II 
Matrox Millennium 
Matrox Millennium G200 



Matrox Millennium G400 



Matrox Millennium G450 

Matrox Millennium G550 

Matrox Millennium II 

Matrox Mystique 

Matrox Mystique G200 

Matrox Productiva G100 

MediaVision Proaxcel 128 

Mirage Z-128 

Miro CRYSTAL VRX 

Miro Crystal 10SD with GenDAC 



Video Card RAM: 32 MB 



Figure 2.12. X Configuration - Video Card 



8.3. Monitor 

After configuring the video card, click on the Monitor tab as shown in Figure 2. 13, "X 
Configuration - Monitor". 
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File Help 

Basic Configuration 
Installation Method 
Boot Loader Options 
Partition Information 
Network Configuration 
Authentication 
Firewall Configuration 



Display Configuration 



Package Selection 
Pre-lnstallation Script 
Post-Installation Script 



Display Configuration 

Configure the X Window System 



General 



Video Card 



Monitor 



□ Probe for monitor 



Monitor 640x480 
Monitor 800x600 
Monitor 1024x768 
Monitor 1280x1024 
Monitor 1400x1050 
Monitor 1600x1200 
LCD Panel 640x480 
LCD Panel 800x600 
LCD Panel 1024x768 
LCD Panel 1280x800 



LCD Panel 1280x1024 



LCD Panel 1400x1050 
LCD Panel 1440x900 
LCD Panel 1600x1200 



□ Use custom monitor sync rates 
Horizontal Sync: 



Vertical Sync: 



Hz 
kHz 



Figure 2.13. X Configuration - Monitor 



Probe for monitor is selected by default. Accept this default to have the installation program 
probe for the monitor during installation. Probing works for most modern monitors. If this option 
is selected and the installation program cannot successfully probe the monitor, the installation 
program stops at the monitor configuration screen. To continue the installation process, select 
your monitor from the list and click Next. 

Alternatively, you can select your monitor from the list. You can also specify the horizontal and 
vertical sync rates instead of selecting a specific monitor by checking the Specify hysnc and 
vsync instead of monitor option. This option is useful if the monitor for the system is not listed. 
Notice that when this option is enabled, the monitor list is disabled. 

9. Package Selection 
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File Help 

Basic Configuration 
Installation Method 
Boot Loader Options 
Partition Information 
Network Configuration 
Authentication 
Firewall Configuration 
Display Configuration 



Package Selection 



Pre-lnstallation Script 
Post-Installation Script 



Package Selection — 
Select packages to install. 

® Automatically Resolve Dependencies 
O ignore Dependencies 



Desktops 



□ X Window System 

D GNOME Desktop Environment 

□ KDE (K Desktop Environment) 



Applications 



□ Editors 

D Engineering and Scientific 

□ Graphical Internet 

□ Text -based Internet 

□ Office/Productivity 
D Sound and Video 
D Graphics 

D Games and Entertainment 
D Authoring and Publishing 



Servers 



D Server Configuration Tools (AS and ES only) 
D Web Server 



Figure 2.14. Package Selection 



The Package Selection window allows you to choose which package groups to install. 

There are also options available to resolve and ignore package dependencies automatically. 

Currently, Kickstart Configurator does not allow you to select individual packages. To install 
individual packages, modify the %packages section of the kickstart file after you save it. Refer to 
Section 5, "Package Selection' 'for details. 

10. Pre-lnstallation Script 
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File Help 

Basic Configuration 
Installation Method 
Boot Loader Options 
Partition Information 
Network Configuration 
Authentication 
Firewall Configuration 
Display Configuration 
Package Selection 



Pre-lnstallation Script 



Post-Installation Script 



Pre-lnstallation Script 

Warning: An error in this script might cause your kickstart installation 
to fail. Do not include the %pre command at the beginning. 



□ Use an interpreter: 



Type your %pre script below: 




Figure 2.15. Pre-lnstallation Script 



You can add commands to run on the system immediately after the kickstart file has been 
parsed and before the installation begins. If you have configured the network in the kickstart file, 
the network is enabled before this section is processed. To include a pre-installation script, type 
it in the text area. 

To specify a scripting language to use to execute the script, select the Use an interpreter 
option and enter the interpreter in the text box beside it. For example, /usr/bin/python2 . 2 can 
be specified for a Python script. This option corresponds to using %pre — interpreter 

/usr/bin/python2 . 2 in your kickstart file. 



Caution 

^Bj^^ Do not include the %pre command. It is added for you. 
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11. Post-Installation Script 



File Help 



Basic Configuration 
Installation Method 
Boot Loader Options 
Partition Information 
Network Configuration 
Authentication 
Firewall Configuration 
Display Configuration 
Package Selection 
Pre-lnstallation Script 



Post-Installation Script 



Post-Installation Script — 

Warning: An error in this script might cause your kickstart installation 
to fail. Do not include the %post command at the beginning. 



D Run outside of the chroot environment 
D Use an interpreter: 



Type your %post script below: 



Figure 2.16. Post-Installation Script 



You can also add commands to execute on the system after the installation is completed. If the 
network is properly configured in the kickstart file, the network is enabled, and the script can 
include commands to access resources on the network. To include a post-installation script, 
type it in the text area. 



Caution 



Do not include the %post command. It is added for you. 



For example, to change the message of the day for the newly installed system, add the 
following command to the %post section: 



echo "Hackers will be punished!" > /etc/mote 
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®Tip 
More examples can be found in Section 7. 1, "Examples". 



11.1. Chroot Environment 

To run the post-installation script outside of the chroot environment, click the checkbox next to 
this option on the top of the Post-Installation window. This is equivalent to using the 

— nochroot option in the %post section. 

To make changes to the newly installed file system, within the post-installation section, but 
outside of the chroot environment, you must prepend the directory name with /mnt/sysimage/. 

For example, if you select Run outside of the chroot environment, the previous example 
must be changed to the following: 

echo "Hackers will be punished!" > /mnt/sysimage/etc/motd 



11.2. Use an Interpreter 

To specify a scripting language to use to execute the script, select the Use an interpreter 
option and enter the interpreter in the text box beside it. For example, /usr/bin/python2 . 2 can 
be specified for a Python script. This option corresponds to using %post —interpreter 

/usr/bin/python2 . 2 in your kickstart file. 

12. Saving the File 

To review the contents of the kickstart file after you have finished choosing your kickstart 
options, select File => Preview from the pull-down menu. 
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You have choosen the following configuration. Click 
Save File to save the kickstart file. 



^Generated by Kickstart Configurator 


* 


#platform=x86, AMD64, or Intel EM64T 




#Systern language 




lang en_US 




#Language modules to install 




langsupport lt_l_T -default=en_US 




#Sy stern keyboard 




keyboard us 




#System mouse 




mouse 




#5ytem timezone 




timezone A m eri c a/N ew_ Y o rk 




#Root password 




rootpw -iscrypted J1JJ Y/IY6oH$OiJHzgl_RsSmHPexaXoffeO 




#Reboot after installation 




reboot 




#lnstall OS instead of upgrade 




install 1 





4 









Cancel 



GjJSave to File 



Figure 2.17. Preview 



To save the kickstart file, click the Save to File button in the preview window. To save the file 
without previewing it, select File => Save File or press Ctrl-S. A dialog box appears. Select 
where to save the file. 

After saving the file, refer to Section 10, "Starting a Kickstart Installation" for information on how 
to start the kickstart installation. 
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PXE Network Installations 

Red Hat Enterprise Linux allows for installation over a network using the NFS, FTP, or HTTP 
protocols. A network installation can be started from a boot CD-ROM, a bootable flash memory 
drive, or by using the askmethod boot option with the Red Hat Enterprise Linux CD #1 . 
Alternatively, if the system to be installed contains a network interface card (NIC) with 
Pre-Execution Environment (PXE) support, it can be configured to boot from files on another 
networked system rather than local media such as a CD-ROM. 

For a PXE network installation, the client's NIC with PXE support sends out a broadcast request 
for DHCP information. The DHCP server provides the client with an IP address, other network 
information such as name server, the IP address or hostname of the tftp server (which 
provides the files necessary to start the installation program), and the location of the files on the 
tftp server. This is possible because of PXELINUX, which is part of the sysiinux package. 

The following steps must be performed to prepare for a PXE installation: 



1. Configure the network (NFS, FTP, HTTP) server to export the installation tree. 

2. Configure the files on the tftp server necessary for PXE booting. 

3. Configure which hosts are allowed to boot from the PXE configuration. 

4. Start the tftp service. 

5. Configure DHCP. 

6. Boot the client, and start the installation. 

1. Setting up the Network Server 

First, configure an NFS, FTP, or HTTP server to export the entire installation tree for the version 
and variant of Red Hat Enterprise Linux to be installed. Refer to the section Preparing for a 
Network Installation in the Red Hat Enterprise Linux Installation Guide for detailed instructions. 

2. PXE Boot Configuration 

The next step is to copy the files necessary to start the installation to the tftp server so they 
can be found when the client requests them. The tftp server is usually the same server as the 
network server exporting the installation tree. 

To copy these files, run the Network Booting Tool on the NFS, FTP, or HTTP server. A 
separate PXE server is not necessary. 

For the command line version of these instructions, refer to Section 2. 1, "Command Line 
Configuration". 
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To use the graphical version of the Network Booting Tool, you must be running the X Window 
System, have root privileges, and have the system-conf ig-netboot RPM package installed. 
To start the Network Booting Tool from the desktop, go to Applications (the main menu on the 
panel) => System Settings => Server Settings => Network Booting Service. Or, type the 
command system-conf ig-netboot at a shell prompt (for example, in an XTerm or a GNOME 
terminal). 

If starting the Network Booting Tool for the first time, select Network Install from the First 
Time Druid. Otherwise, select Configure => Network Installation from the pulldown menu, 
and then click Add. The dialog in Figure 3. 1, "Network Installation Setup" is displayed. 



1 



Operating system identifier 
Description: 

Select protocol for installation: 

Kickstart: 
Software: 
Server: 



rhel4-as 



RHEL4 AS 



NFS 



http://www.example.com/ks/ks.cfg 



Location: 



server.example.com 



/misc/RH EL4/AS/i386/tree/ 



Anonymous FTP 
User: 



Password: 



Cancel 



4 OK 



Figure 3.1. Network Installation Setup 



• Operating system identifier — Provide a unique name using one word to identify the Red 
Hat Enterprise Linux version and variant. It is used as the directory name in the 

/tftpboot/linux-install/ directory. 

• Description — Provide a brief description of the Red Hat Enterprise Linux version and 
variant. 

• Selects protocol for installation — Selects NFS, FTP, or HTTP as the network installation 
type depending on which one was configured previously. If FTP is selected and anonymous 
FTP is not being used, uncheck Anonymous FTP and provide a valid username and 
password combination. 
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• Kickstart — Specify the location of the kickstart file. The file can be a URL or a file stored 
locally (diskette). The kickstart file can be created with the Kickstart Configurator. Refer to 
Chapter 2, Kickstart Configurator tor details. 

• Server — Provide the IP address or domain name of the NFS, FTP, or HTTP server. 

• Location — Provide the directory shared by the network server. If FTP or HTTP was 
selected, the directory must be relative to the default directory for the FTP server or the 
document root for the HTTP server. For all network installations, the directory provided must 
contain the RedHat/ directory of the installation tree. 

After clicking OK, the initrd . img and vmiinuz files necessary to boot the installation program 
are transfered from images/pxeboot/ in the provided installation tree to 
/tftpboot/iinux-instaii/<os-identifier>/ on the tftp server (the one you are running 
the Network Booting Tool on). 

2.1. Command Line Configuration 

If the network server is not running X, the pxeos command line utility, which is part of the 

system-config-netboot package, can be used to configure the tftp server files : 

pxeos -a -i " <description>" -p <NFS | HTTP | FTP> -D -s client.example.com \ 
-L <net-location> -k <kernel> -K <kickstart><os-identifer> 

The following list explains the options: 



• -a — Specifies that an OS instance is being added to the PXE configuration. 

• -i "<description>" — Replace " <description>" with a description of the OS instance. This 
corresponds to the Description field in Figure 3.1, "Network Installation Setup". 

- - P <NFS|HTTP|FTP> — Specify which of the NFS, FTP, or HTTP protocols to use for 
installation. Only one may be specified. This corresponds to the Select protocol for 
installation menu in Figure 3.1, "Network Installation Setup". 

• -d <0|1 > — Specify "o" which indicates that it is not a diskless configuration since pxeos can 
be used to configure a diskless environment as well. 

• -sciient . example .com — Provide the name of the NFS, FTP, or HTTP server after the -s 
option. This corresponds to the Server field in Figure 3. 1, "Network Installation Setup". 

• -L<net-iocation> — Provide the location of the installation tree on that server after the -l 
option. This corresponds to the Location field in Figure 3. 1, "Network Installation Setup". 

• -k<kemei> — Provide the specific kernel version of the server installation tree for booting. 

• -K<kickstart> — Provide the location of the kickstart file, if available. 
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• <os-identifer> — Specify the OS identifier, which is used as the directory name in the 
/tftpboot/iinux-instaii/ directory. This corresponds to the Operating system identifier 
field in Figure 3. 1, "Network Installation Setup". 

If FTP is selected as the installation protocol and anonymous login is not available, specify a 
username and password for login, with the following options before <os-±dentifer> in the 
previous command: 

-A -u <username> -p <password> 

For more information on command line options available for the pxeos command, refer to the 
pxeos man page. 

3. Adding PXE Hosts 



After configuring the network server, the interface as shown in Figure 3.2, "Add Hosts"\s 
displayed. 



File Configure Help 


/■ 


New Properties 


Delete 










Hostname * 


Operating System 


IP Address 


* 






























4 


I 








► 













Figure 3.2. Add Hosts 



The next step is to configure which hosts are allowed to connect to the PXE boot server. For the 
command line version of this step, refer to Section 3.1, "Command Line Configuration". 

To add hosts, click the New button. 
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Hostname or IP Address/Subnet: 
Operating System: 

Diskless OS 



Snapshot name 
Ethernet: 



ethD 



Figure 3.3. Add a Host 



client.example.com 



rhel-4-as 



□ Serial Console 

Network OS Install 

Kickstart File: 




Enter the following information: 



• Hostname or IP Address/Subnet — The IP address, fully qualified hostname, or a subnet of 
systems that should be allowed to connect to the PXE server for installations. 

• Operating System — The operating system identifier to install on this client. The list is 
populated from the network install instances created from the Network Installation Dialog. 

• Serial Console — This option allows use of a serial console. 

• Kickstart File — The location of a kickstart file to use, such as 

http://server.example.com/kickstart/ks.cfg. This file Can be Created with the 

Kickstart Configurator. Refer to Chapter 2, Kickstart Configurator tor details. 

Ignore the Snapshot name and Ethernet options. They are only used for diskless 
environments. For more information on configuring a diskless environment, refer to Chapter 4, 
Diskless Environments for details. 

3.1. Command Line Configuration 

If the network server is not running X, the pxeboot utility, a part of the system-conf ig-netboot 
package, can be used to add hosts which are allowed to connect to the PXE server: 

pxeboot -a -K <kickstart> -0 <os-identifier> -r <value><host> 



The following list explains the options: 



• -a — Specifies that a host is to be added. 
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• -K<kickstart> — The location of the kickstart file, if available. 

• -o<os-identifier> — Specifies the operating system identifier as defined in Section 2, 
"PXE Boot Configuration". 

• -r<vaiue> — Specifies the ram disk size. 

• <host> — Specifies the IP address or hostname of the host to add. 

For more information on command line options available for the pxeboot command, refer to the 

pxeboot man page. 

4. Adding a Custom Boot Message 

Optionally, modify /tftpboot/iinux-instaii/msgs/boot .msg to use a custom boot message. 

5. Performing the PXE Installation 

For instructions on how to configure the network interface card with PXE support to boot from 
the network, consult the documentation for the NIC. It varies slightly per card. 

After the system boots the installation program, refer to the Red Hat Enterprise Linux Installation 
Guide. 
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Diskless Environments 

Some networks require multiple systems with the same configuration. They also require that 
these systems be easy to reboot, upgrade, and manage. One solution is to use a diskless 
environment in which most of the operating system, which can be read-only, is shared from a 
central server between the clients. The individual clients have their own directories on the 
central server for the rest of the operating system, which must be read/write. Each time the 
client boots, it mounts most of the OS from the NFS server as read-only and another directory 
as read-write. Each client has its own read-write directory so that one client can not affect the 
others. 

The following steps are necessary to configure Red Hat Enterprise Linux to run on a diskless 
client: 



1 . Install Red Hat Enterprise Linux on a system so that the files can be copied to the NFS 
server. (Refer to the Red Hat Enterprise Linux Installation Guide for details.) Any software to 
be used on the clients must be installed on this system and the busybox-anaconda package 
must be installed. 

2. Create a directory on the NFS server to contain the diskless environment such as 

/diskiess/i386/RHEL4-AS/. For example: 

mkdir -p /diskless/i386/RHEL4-AS/ 

This directory is referred to as the diskless directory. 

3. Create a subdirectory of this directory named root/: 

mkdir -p /diskless/i386/RHEL4-AS/root/ 

4. Copy Red Hat Enterprise Linux from the client system to the server using rsync. For 
example: 

rsync -a -e ssh installed-system . example . com : / 
/diskless/i38 6/RHEL4-AS/root/ 

The length of this operation depends on the network connection speed as well as the size of 
the file system on the installed system. Depending on these factors, this operation may take 
a while. 

5. Start the tftp server 

6. Configure the DHCP server 

7. Finish creating the diskless environment as discussed in Section 2, "Finish Configuring the 
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Diskless Environment". 

8. Configure the diskless clients as discussed in Section 3, "Adding Hosts". 

9. Configure each diskless client to boot via PXE and boot them. 

1. Configuring the NFS Server 

The shared read-only part of the operating system is shared via NFS. 



Configure NFS to export the root/ and snapshot/ directories by adding them to 

/etc/exports. For example: 



/diskless/ 135 


S6/RHEL4- 


-AS/root/ 


* (ro, sync, no_root_squash) 


/diskless/ 13 { 


S6/RHEL4- 


-AS/ snapshot/ 


* (rw, sync, no_root_squash) 



Replace * with one of the hostname formats discussed in Section 3.2, "Hostname Formats". 
Make the hostname declaration as specific as possible, so unwanted systems can not access 
the NFS mount. 

If the NFS service is not running, start it: 

service nfs start 

If the NFS service is already running, reload the configuration file: 

service nfs reload 

2. Finish Configuring the Diskless Environment 

To use the graphical version of the Network Booting Tool, you must be running the X Window 
System, have root privileges, and have the system-conf ig-netboot RPM package installed. 
To start the Network Booting Tool from the desktop, go to Applications (the main menu on the 
panel) => System Settings => Server Settings => Network Booting Service. Or, type the 
command system-conf ig-netboot at a shell prompt (for example, in an XTerm or a GNOME 
terminal). 

If starting the Network Booting Tool for the first time, select Diskless from the First Time 
Druid. Otherwise, select Configure => Diskless from the pull-down menu, and then click Add. 

A wizard appears to step you through the process: 



1 . Click Forward on the first page. 
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2. On the Diskless Identifier page, enter a Name and Description for the diskless 
environment. Click Forward. 

3. Enter the IP address or domain name of the NFS server configured in Section 1, "Configuring 
the NFS Server" as well as the directory exported as the diskless environment. Click 
Forward. 

4. The kernel versions installed in the diskless environment are listed. Select the kernel version 
to boot on the diskless system. 

5. Click Apply to finish the configuration. 

After clicking Apply, the diskless kernel and image file are created based on the kernel 
selected. They are copied to the PXE boot directory 

/tftpboot/iinux-instaii/ <os-identifier>/. The directory snapshot/ is created in the 
same directory as the root/ directory (for example, /diskiess/i386/RHEL4-AS/snapshot/) 
with a file called files in it. This file contains a list of files and directories that must be 
read/write for each diskless system. Do not modify this file. If additional entries must be added 
to the list, create a files . custom file in the same directory as the files file, and add each 
additional file or directory on a separate line. 

3. Adding Hosts 

Each diskless client must have its own snapshot directory on the NFS server that is used as its 
read/write file system. The Network Booting Tool can be used to create these snapshot 
directories. 

After completing the steps in Section 2, "Finish Configuring the Diskless Environment", a 
window appears to allow hosts to be added for the diskless environment. Click the New button. 
In the dialog shown in Figure 4. 1, "Add Diskless Host", provide the following information: 

• Hostname or IP Address/Subnet — Specify the hostname or IP address of a system to add 
it as a host for the diskless environment. Enter a subnet to specify a group of systems. 

• Operating System — Select the diskless environment for the host or subnet of hosts. 

• Serial Console — Select this checkbox to perform a serial installation. 

• Snapshot name — Provide a subdirectory name to be used to store all of the read/write 
content for the host. 

• Ethernet — Select the Ethernet device on the host to use to mount the diskless environment. 
If the host only has one Ethernet card, select ethO. 

Ignore the Kickstart File option. It is only used for PXE installations. 
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Hostname or IP Address/Subnet: 
Operating System: 



Diskle ss OS 

Snapshot nameltestl 



Ethernet: 



ethO 



192.163.1.1 



rhel-4-as 



□ Serial Console 

Network OS Install 

Kickstart File: 




Figure 4.1. Add Diskless Host 



In the existing snapshot/ directory in the diskless directory, a subdirectory is created with the 
Snapshot name specified as the file name. Then, all of the files listed in snapshot /files and 

snapshot /files . custom are copied copy from the root / directory to this new directory. 

4. Booting the Hosts 

Consult the documentation for your PXE card to configure the host to boot via PXE. 

When the diskless client boots, it mounts the remote root / directory in the diskless directory as 
read-only. It also mounts its individual snapshot directory as read/write. Then it mounts all the 
files and directories in the files and files . custom files using the mount -o bind over the 
read-only diskless directory to allow applications to write to the root directory of the diskless 
environment if they need to. 
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Basic System Recovery 

When things go wrong, there are ways to fix problems. However, these methods require that 
you understand the system well. This chapter describes how to boot into rescue mode, 
single-user mode, and emergency mode, where you can use your own knowledge to repair the 
system. 

1. Common Problems 

You might need to boot into one of these recovery modes for any of the following reasons: 



• You are unable to boot normally into Red Hat Enterprise Linux (runlevel 3 or 5). 

• You are having hardware or software problems, and you want to get a few important files off 
of your system's hard drive. 

• You forgot the root password. 

1.1. Unable to Boot into Red Hat Enterprise Linux 

This problem is often caused by the installation of another operating system after you have 
installed Red Hat Enterprise Linux. Some other operating systems assume that you have no 
other operating system(s) on your computer. They overwrite the Master Boot Record (MBR) that 
originally contained the GRUB boot loader. If the boot loader is overwritten in this manner, you 
cannot boot Red Hat Enterprise Linux unless you can get into rescue mode and reconfigure the 
boot loader. 

Another common problem occurs when using a partitioning tool to resize a partition or create a 
new partition from free space after installation, and it changes the order of your partitions. If the 
partition number of your / partition changes, the boot loader might not be able to find it to mount 
the partition. To fix this problem, boot in rescue mode and modify the /boot/grub/grub . conf 
file. 

For instructions on how to reinstall the GRUB boot loader from a rescue environment, refer to 
Section 2. 1, "Reinstalling the Boot Loader". 

1 .2. Hardware/Software Problems 

This category includes a wide variety of different situations. Two examples include failing hard 
drives and specifying an invalid root device or kernel in the boot loader configuration file. If 
either of these occur, you might not be able to reboot into Red Hat Enterprise Linux. However, if 
you boot into one of the system recovery modes, you might be able to resolve the problem or at 
least get copies of your most important files. 

1 .3. Root Password 
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What can you do if you forget your root password? To reset it to a different password, boot into 
rescue mode or single-user mode, and use the passwd command to reset the root password. 

2. Booting into Rescue Mode 

Rescue mode provides the ability to boot a small Red Hat Enterprise Linux environment entirely 
from CD-ROM, or some other boot method, instead of the system's hard drive. 

As the name implies, rescue mode is provided to rescue you from something. During normal 
operation, your Red Hat Enterprise Linux system uses files located on your system's hard drive 
to do everything — run programs, store your files, and more. 

However, there may be times when you are unable to get Red Hat Enterprise Linux running 
completely enough to access files on your system's hard drive. Using rescue mode, you can 
access the files stored on your system's hard drive, even if you cannot actually run Red Hat 
Enterprise Linux from that hard drive. 

To boot into rescue mode, you must be able to boot the system using one of the following 
methods 1 : 



• By booting the system from an installation boot CD-ROM. 

• By booting the system from other installation boot media, such as USB flash devices. 

• By booting the system from the Red Hat Enterprise Linux CD-ROM #1 . 

Once you have booted using one of the described methods, add the keyword rescue as a 
kernel parameter. For example, for an x86 system, type the following command at the 
installation boot prompt: 

linux rescue 

You are prompted to answer a few basic questions, including which language to use. It also 
prompts you to select where a valid rescue image is located. Select from Local CD-ROM, Hard 
Drive, NFS image, FTP, or HTTP. The location selected must contain a valid installation tree, 
and the installation tree must be for the same version of Red Hat Enterprise Linux as the Red 
Hat Enterprise Linux disk from which you booted. If you used a boot CD-ROM or other media to 
start rescue mode, the installation tree must be from the same tree from which the media was 
created. For more information about how to setup an installation tree on a hard drive, NFS 
server, FTP server, or HTTP server, refer to the earlier section of this guide. 

If you select a rescue image that does not require a network connection, you are asked whether 
or not you want to establish a network connection. A network connection is useful if you need to 
backup files to a different computer or install some RPM packages from a shared network 



1 Refer to the earlier sections of this guide for more details. 
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location, for example. 

The following message is displayed: 

The rescue environment will now attempt to find your Linux installation and 
mount it under the directory /mnt/sysimage . You can then make any changes 
required to your system. If you want to proceed with this step choose 
'Continue' . You can also choose to mount your file systems read-only instead 
of read-write by choosing 'Read-only'. If for some reason this process fails 
you can choose 'Skip' and this step will be skipped and you will go directly 
to a command shell. 

If you select Continue, it attempts to mount your file system under the directory 
/mnt/sysimage/. If it fails to mount a partition, it notifies you. If you select Read-Only, it 
attempts to mount your file system under the directory /mnt/sysimage/, but in read-only mode. 
If you select Skip, your file system is not mounted. Choose Skip if you think your file system is 
corrupted. 

Once you have your system in rescue mode, a prompt appears on VC (virtual console) 1 and 
VC 2 (use the Ctrl-Alt-F1 key combination to access VC 1 and Ctrl-Alt-F2 to access VC 2): 

sh-3 . 00b# 

If you selected Continue to mount your partitions automatically and they were mounted 
successfully, you are in single-user mode. 

Even if your file system is mounted, the default root partition while in rescue mode is a 
temporary root partition, not the root partition of the file system used during normal user mode 
(runlevel 3 or 5). If you selected to mount your file system and it mounted successfully, you can 
change the root partition of the rescue mode environment to the root partition of your file system 
by executing the following command: 

chroot /mnt/sysimage 

This is useful if you need to run commands such as rpm that require your root partition to be 
mounted as /. To exit the chroot environment, type exit to return to the prompt. 

If you selected Skip, you can still try to mount a partition or LVM2 logical volume manually 
inside rescue mode by creating a directory such as /foo, and typing the following command: 

mount -t ext3 /dev/mapper/VolGroup00-LogVol02/ foo 

In the above command, /foo is a directory that you have created and 

/dev/mapper/voiGroupoo-Logvoi02 is the LVM2 logical volume you want to mount. If the 
partition is of type ext2, replace ext3 with ext2. 
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If you do not know the names of all physical partitions, use the following command to list them: 

fdisk -1 

If you do not know the names of all LVM2 physical volumes, volume groups, or logical volumes, 
use the following commands to list them: 

pvdisplay 
vgdisplay 
lvdisplay 

From the prompt, you can run many useful commands, such as: 

• ssh, scp, and ping if the network is started 

• dump and restore for users with tape drives 

• parted and fdisk for managing partitions 

• rpm for installing or upgrading software 

• joe for editing configuration files 



Note 

V If you try to start other popular editors such as emacs, pico, or vi, the joe editor 

is started. 



2.1. Reinstalling the Boot Loader 

In many cases, the GRUB boot loader can mistakenly be deleted, corrupted, or replaced by 
other operating systems. 

The following steps detail the process on how GRUB is reinstalled on the master boot record: 

• Boot the system from an installation boot medium. 

• Type ii nux rescue at the installation boot prompt to enter the rescue environment. 
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• Type chroot /mnt/sysimage to mount the root partition. 

• Type /sbin/grub-install /dev/hda to reinstall the GRUB boot loader, Where /dev/hda is 

the boot partition. 

• Review the /boot/grub/grub . conf file, as additional entries may be needed for GRUB to 
control additional operating systems. 

• Reboot the system. 

3. Booting into Single-User Mode 

One of the advantages of single-user mode is that you do not need a boot CD-ROM; however, it 
does not give you the option to mount the file systems as read-only or not mount them at all. 

If your system boots, but does not allow you to log in when it has completed booting, try 
single-user mode. 

In single-user mode, your computer boots to runlevel 1 . Your local file systems are mounted, but 
your network is not activated. You have a usable system maintenance shell. Unlike rescue 
mode, single-user mode automatically tries to mount your file system. Do not use single-user 
mode if your file system cannot be mounted successfully. You cannot use single-user mode if 
the runlevel 1 configuration on your system is corrupted. 

On an x86 system using GRUB, use the following steps to boot into single-user mode: 



1 . At the GRUB splash screen at boot time, press any key to enter the GRUB interactive menu. 

2. Select Red Hat Enterprise Linux with the version of the kernel that you wish to boot and 
type a to append the line. 

3. Go to the end of the line and type single as a separate word (press the Spacebar and then 
type single). Press Enter to exit edit mode. 

4. Booting into Emergency Mode 

In emergency mode, you are booted into the most minimal environment possible. The root file 
system is mounted read-only and almost nothing is set up. The main advantage of emergency 
mode over single-user mode is that the init files are not loaded. If init is corrupted or not 
working, you can still mount file systems to recover data that could be lost during a 
re-installation. 

To boot into emergency mode, use the same method as described for single-user mode in 
Section 3, "Booting into Single-User Mode' 'with one exception, replace the keyword single 

With the keyword emergency. 



71 



72 



Part II. File Systems 



File system refers to the files and directories stored on a computer. A file system can have 
different formats called file system types. These formats determine how the information is stored 
as files and directories. Some file system types store redundant copies of the data, while some 
file system types make hard drive access faster. This part discusses the ext3, swap, RAID, and 
LVM file system types. It also discusses the parted utility to manage partitions and access 
control lists (ACLs) to customize file permissions. 



Chapter 6. 



The ext3 File System 

The default file system is the journaling ext3 file system. 

1. Features of ext3 

The ext3 file system is essentially an enhanced version of the ext2 file system. These 
improvements provide the following advantages: 



Availability 

After an unexpected power failure or system crash (also called an unclean system 
shutdown), each mounted ext2 file system on the machine must be checked for consistency 
by the e2f sck program. This is a time-consuming process that can delay system boot time 
significantly, especially with large volumes containing a large number of files. During this 
time, any data on the volumes is unreachable. 

The journaling provided by the ext3 file system means that this sort of file system check is 
no longer necessary after an unclean system shutdown. The only time a consistency check 
occurs using ext3 is in certain rare hardware failure cases, such as hard drive failures. The 
time to recover an ext3 file system after an unclean system shutdown does not depend on 
the size of the file system or the number of files; rather, it depends on the size of the journal 
used to maintain consistency. The default journal size takes about a second to recover, 
depending on the speed of the hardware. 

Data Integrity 

The ext3 file system provides stronger data integrity in the event that an unclean system 
shutdown occurs. The ext3 file system allows you to choose the type and level of protection 
that your data receives. By default, the ext3 volumes are configured to keep a high level of 
data consistency with regard to the state of the file system. 

Speed 

Despite writing some data more than once, ext3 has a higher throughput in most cases than 
ext2 because ext3's journaling optimizes hard drive head motion. You can choose from 
three journaling modes to optimize speed, but doing so means trade-offs in regards to data 
integrity. 

Easy Transition 

It is easy to migrate from ext2 to ext3 and gain the benefits of a robust journaling file system 
without reformatting. Refer to Section 3, "Converting to an ext3 File System" for more on 
how to perform this task. 

The following sections walk you through the steps for creating and tuning ext3 partitions. For 
ext2 partitions, skip the partitioning and formating sections below and go directly to Section 3, 
"Converting to an ext3 File System". 



75 



Chapter 6. The ext3 File System 



2. Creating an ext3 File System 

After installation, it is sometimes necessary to create a new ext3 file system. For example, if you 
add a new disk drive to the system, you may want to partition the drive and use the ext3 file 
system. 

The steps for creating an ext3 file system are as follows: 



1 . Create the partition using parted or f disk. 

2. Format the partition with the ext3 file system using mkf s. 

3. Label the partition using e2iabei. 

4. Create the mount point. 

5. Add the partition to the /etc/f stab file. 

3. Converting to an ext3 File System 

The tune2f s program can add a journal to an existing ext2 file system without altering the data 
already on the partition. If the file system is already mounted while it is being transitioned, the 
journal is visible as the file . journal in the root directory of the file system. If the file system is 
not mounted, the journal is hidden and does not appear in the file system at all. 



Note 



A default installation of Red Hat Enterprise Linux uses ext3 for all file systems. 




To convert an ext2 file system to ext3, log in as root and type, 



/sbin/tune2 f s -j <file_system> 



where <fiie_system> is an appropriate LVM2 file system. 
A valid LVM2 file system could be one of two types of entries: 



• A mapped device — A logical volume in a volume group, for example, 

/dev/mapper /VolGroupOO-LogVol02. 

• A static device — A traditional storage volume, for example, /dev/hdbx, where hdb is a 
storage device name and xis the partition number. 

Issue the df command to display mounted file systems. For more detailed information on the 
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LVM file system, refer to Chapter 8, LVM Configuration. 

For the remainder of this section, the sample commands use the following value: 

/ dev/mapper/VolGroupOO-LogVol02 

After doing this, be certain to change the partition type from ext2 to ext3 in the /etc/f stab file 

If you are transitioning your root file system, you must use an initrd image (or RAM disk) to 
boot. To create this, run the mkinitrd program. For information on using the mkinitrd 
command, type man mkinitrd. Also, make sure your GRUB configuration loads the initrd. 

If you fail to make this change, the system still boots, but the file system is mounted as ext2 
instead of ext3. 

4. Reverting to an ext2 File System 

Because ext3 is relatively new, some disk utilities do not yet support it. For example, you may 
need to shrink a partition with resize2f s, which does not yet support ext3. In this situation, it 
may be necessary to temporarily revert a file system to ext2. 

To revert a partition, you must first unmount the partition by logging in as root and typing, 

uraount / dev/mapper/VolGroupOO-LogVol 02 

Next, change the file system type to ext2 by typing the following command as root: 

/sbin/tune2f s -0 A has_journal /dev/mapper/VolGroupOO-LogVol02 

Check the partition for errors by typing the following command as root: 

/sbin/e2fsck -y /dev/mapper/VolGroupOO-LogVol02 

Then mount the partition again as ext2 file system by typing: 

mount -t ext2 /dev/mapper/VolGroupOO-LogVol02 /mount /point 

In the above command, replace /mount/point with the mount point of the partition. 

Next, remove the . journal file at the root level of the partition by changing to the directory 
where it is mounted and typing: 

rm -f . journal 
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You now have an ext2 partition. 

If you want to permanently change the partition to ext2, remember to update the /etc/f stab 
file. 
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Logical Volume Manager (LVM) 

1 . What is LVM? 

LVM is a method of allocating hard drive space into logical volumes that can be easily resized 
instead of partitions. 

With LVM, a hard drive or set of hard drives is allocated to one or more physical volumes. A 
physical volume cannot span over more than one drive. 

The physical volumes are combined into logical volume groups, with the exception of the 
/boot/ partition. The /boot/ partition cannot be on a logical volume group because the boot 
loader cannot read it. If the root (/) partition is on a logical volume, create a separate /boot/ 
partition which is not a part of a volume group. 



Since a physical volume cannot span over multiple drives, to span over more than one drive, 
create one or more physical volumes per drive. 




Figure 7.1. Logical Volume Group 



The logical volume group is divided into logical volumes, which are assigned mount points, such 
as /home and / m and file system types, such as ext2 or ext3. When "partitions" reach their full 
capacity, free space from the logical volume group can be added to the logical volume to 
increase the size of the partition. When a new hard drive is added to the system, it can be 
added to the logical volume group, and partitions that are logical volumes can be expanded. 
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Figure 7.2. Logical Volumes 

On the other hand, if a system is partitioned with the ext3 file system, the hard drive is divided 
into partitions of defined sizes. If a partition becomes full, it is not easy to expand the size of the 
partition. Even if the partition is moved to another hard drive, the original hard drive space has 
to be reallocated as a different partition or not used. 

LVM support must be compiled into the kernel, and the default Red Hat kernel is compiled with 
LVM support. 

To learn how to configure LVM during the installation process, refer to Chapter 8, LVM 
Configuration. 

2. What is LVM2? 

LVM version 2, or LVM2, is the default for Red Hat Enterprise Linux, which uses the device 
mapper driver contained in the 2.6 kernel. LVM2, which is almost completely compatible with 
the earlier LVM1 version, can be upgraded from versions of Red Hat Enterprise Linux running 
the 2.4 kernel. 

Although upgrading from LVM1 to LVM2 is usually seamless, refer to Section 3, "Additional 
Resources' 'for further details on more complex requirements and upgrading scenarios. 

3. Additional Resources 

Use these sources to learn more about LVM. 

3.1. Installed Documentation 
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• rpm -qd lvm — This command shows all the documentation available from the ivm package, 
including man pages. 

• ivm help — This command shows all LVM commands available. 

3.2. Useful Websites 

• http://sourceware.org/lvm2 — LVM2 webpage, which contains an overview, link to the mailing 
lists, and more. 

• http://tldp.org/HOWTO/LVM-HOWTO/— LVM HOWTOtrom the Linux Documentation 
Project. 
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LVM Configuration 

LVM can be configured during the graphical installation process, the text-based installation 
process, or during a kickstart installation. You can use the utilities from the ivm package to 
create your own LVM configuration post-installation, but these instructions focus on using Disk 
Druid during installation to complete this task. 

Read Chapter 7, Logical Volume Manager (LVM) first to learn about LVM. An overview of the 
steps required to configure LVM include: 



• Creating physical volumes from the hard drives. 

• Creating volume groups from the physical volumes. 

• Creating logical volumes from the volume groups and assign the logical volumes mount 
points. 



Note 

Although the following steps are illustrated during a GUI installation, the same 
can be done during a text-based installation. 



Two 9.1 GB SCSI drives (/dev/sda and /dev/sdb) are used in the following examples. They 
detail how to create a simple configuration using a single LVM volume group with associated 
logical volumes during installation. 

1. Automatic Partitioning 

On the Disk Partitioning Setup screen, select Automatically partition. 

For Red Hat Enterprise Linux, LVM is the default method for disk partitioning. If you do not wish 
to have LVM implemented, or if you require RAID partitioning, manual disk partitioning through 
Disk Druid is required. 

The following properties make up the automatically created configuration: 



• The /boot/ partition resides on its own non-LVM partition. In the following example, it is the 
first partition on the first drive (/dev/sdai). Bootable partitions cannot reside on LVM logical 
volumes. 

• A single LVM volume group (voiGroupOO) is created, which spans all selected drives and all 
remaining space available. In the following example, the remainder of the first drive 
(/dev/sda2), and the entire second drive (/dev/sdbi) are allocated to the volume group. 
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Two LVM logical volumes (Logvoioo and Logvoioi) are created from the newly created 
spanned volume group. In the following example, the recommended swap space is 
automatically calculated and assigned to Logvoioi, and the remainder is allocated to the root 
file system, Logvoioo. 



Disk Setup 
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Red Hat Enterprise Linux AS to 
be installed. 

If you do not know how to 
partition your system or if you 
need help with using the 
manual partitioning tools, refer 
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partitioning, you can either 
accept the current partition 
settings (click Next), or modify 
the setup using the manual 
partitioning tool. 

If you are manually partitioning 
your system, you can see your 
current hard drive(s) and 
partitions displayed below. Use 
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Figure 8.1. Automatic LVM Configuration With Two SCSI Drives 



Note 

If enabling quotas are of interest to you, it may be best to modify the automatic 
configuration to include other mount points, such as /home/ or /var/, so that 
each file system has its own independent quota configuration limits. 

In most cases, the default automatic LVM partitioning is sufficient, but advanced 
implementations could warrant modification or manual configuration of the LVM 
partition tables. 
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Note 

If you anticipate future memory upgrades, leaving some free space in the volume 
group would allow for easy future expansion of the swap space logical volume on 
the system; in which case, the automatic LVM configuration should be modified 
to leave available space for future growth. 



2. Manual LVM Partitioning 

The following section explains how to manually configure LVM for Red Hat Enterprise Linux. 
Because there are numerous ways to manually configure a system with LVM, the following 
example is similar to the default configuration done in Section 1, "Automatic Partitioning". 

On the Disk Partitioning Setup screen, select Manually partition with Disk Druid. 

2.1. Creating the /boot/ Partition 

In a typical situation, the disk drives are new, or formatted clean. The following figure, 

Figure 8.2, 'Two Blank Drives, Ready For Configuration", shows both drives as raw devices with 

no partitioning configured. 
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Figure 8.2. Two Blank Drives, Ready For Configuration 



Warning 



The /boot/ partition cannot reside on an LVM volume group because the GRUB 
boot loader cannot read it. 



1 . Select New. 

2. Select /boot from the Mount Point pulldown menu. 

3. Select ext3 from the File System Type pulldown menu. 

4. Select only the sda checkbox from the Allowable Drives area. 

5. Leave 100 (the default) in the Size (MB) menu. 

6. Leave the Fixed size (the default) radio button selected in the Additional Size Options 
area. 

7. Select Force to be a primary partition to make the partition be a primary partition. A 
primary partition is one of the first four partitions on the hard drive. If unselected, the partition 
is created as a logical partition. If other operating systems are already on the system, 
unselecting this option should be considered. For more information on primary versus 
logical/extended partitions, refer to the appendix section of the Red Hat Enterprise Linux 
Installation Guide. 

Refer to Figure 8.3, "Creation of the Boot Partition" to verify your inputted values: 
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Mount Point: 
File System Type: 

Allowable Drives: 



ext3 



Add Partition 
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□ sdb 8E7E MB IBM-PSG ST39204LC !# 



Size (MB): [100 

Additional Size Options 
® Fixed size 

O Fill all space up to (MB): 

O Fill to maximum allowable size 



0F orce T0 be a primaty partition 



X Cancel 



$ OK 



Figure 8.3. Creation of the Boot Partition 



Click OK to return to the main screen. The following figure displays the boot partition correctly 
set: 
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Disk Setup 
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Red Hat Enterprise Linux AS to 
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need help with using the 
manual partitioning tools, refer 
to the product documentation. 

If you used automatic 
partitioning, you can either 
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settings (click Next), or modify 
the setup using the manual 
partitioning tool. 

If you are manually partitioning 
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current hard drive(s) and 
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Figure 8.4. The /boot/ Partition Displayed 



2.2. Creating the LVM Physical Volumes 

Once the boot partition is created, the remainder of all disk space can be allocated to LVM 
partitions. The first step in creating a successful LVM implementation is the creation of the 
physical volume(s). 



1 . Select New. 



2. Select physical volume (LVM) from the File System Type pulldown menu as shown in 

Figure 8.5, "Creating a Physical Volume". 
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Mount Point: 
File System iype: 

Allowable Drives: 
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Cancel 
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Figure 8.5. Creating a Physical Volume 



3. You cannot enter a mount point yet (you can once you have created all your physical 
volumes and then all volume groups). 

4. A physical volume must be constrained to one drive. For Allowable Drives, select the drive 
on which the physical volume are created. If you have multiple drives, all drives are selected, 
and you must deselect all but one drive. 

5. Enter the size that you want the physical volume to be. 

6. Select Fixed size to make the physical volume the specified size, select Fill all space up to 
(MB) and enter a size in MBs to give range for the physical volume size, or select Fill to 
maximum allowable size to make it grow to fill all available space on the hard disk. If you 
make more than one growable, they share the available free space on the disk. 

7. Select Force to be a primary partition if you want the partition to be a primary partition. 

8. Click OK to return to the main screen. 

Repeat these steps to create as many physical volumes as needed for your LVM setup. For 
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example, if you want the volume group to span over more than one drive, create a physical 
volume on each of the drives. The following figure shows both drives completed after the 
repeated process: 
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Figure 8.6. Two Physical Volumes Created 



2.3. Creating the LVM Volume Groups 

Once all the physical volumes are created, the volume groups can be created: 



1 . Click the LVM button to collect the physical volumes into volume groups. A volume group is 
basically a collection of physical volumes. You can have multiple logical volume groups, but a 
physical volume can only be in one volume group. 




Note 



There is overhead disk space reserved in the logical volume group. The 
summation of the physical volumes may not equal the size of the volume group; 
however, the size of the logical volumes shown is correct. 



90 



Creating the LVM Logical Volumes 



Make LVM Volume Group 



Volume Group Name: 
Physical Extent: 
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Used Space: 
Free Space: 
Total Space: 
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Delete 
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Figure 8.7. Creating an LVM Volume Group 



2. Change the Volume Group Name if desired. 
3. 

All logical volumes inside the volume group must be allocated in physical extent units. By 
default, the physical extent is set to 32 MB; thus, logical volume sizes must be divisible by 32 
MBs. If you enter a size that is not a unit of 32 MBs, the installation program automatically 
selects the closest size in units of 32 MBs. It is not recommended that you change this 
setting. 

4. Select which physical volumes to use for the volume group. 

2.4. Creating the LVM Logical Volumes 

Create logical volumes with mount points such as /, /home/, and swap space. Remember that 
/boot cannot be a logical volume. To add a logical volume, click the Add button in the Logical 
Volumes section. A dialog window as shown in Figure 8.8, "Creating a Logical Volume" 
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appears. 



Make Logical Volume 



Mount Point: 
File System Type: 
Logical Volume Ne 
Size (MB): 



<Not Applicable 


V 


swap 


|v 


LogVol02 


1024] 


(Max size is 2112 ME) 


K Cancel 







Figure 8.8. Creating a Logical Volume 



Repeat these steps for each volume group you want to create. 



Tip 

You may want to leave some free space in the logical volume group so you can 
expand the logical volumes later. The default automatic configuration does not 
do this, but this manual configuration example does — approximately 1 GB is left 
as free space for future expansion. 
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Figure 8.9. Pending Logical Volumes 



Click OK to apply the volume group and all associated logical volumes. 
The following figure shows the final manual configuration: 
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Figure 8.10. Final Manual Configuration 
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Redundant Array of Independent 
Disks (RAID) 

1. What is RAID? 

The basic idea behind RAID is to combine multiple small, inexpensive disk drives into an array 
to accomplish performance or redundancy goals not attainable with one large and expensive 
drive. This array of drives appears to the computer as a single logical storage unit or drive. 

RAID is a method in which information is spread across several disks. RAID uses techniques 
such as disk striping (RAID Level 0), disk mirroring (RAID level 1), and disk striping with parity 
(RAID Level 5) to achieve redundancy, lower latency and/or to increase bandwidth for reading 
or writing to disks, and to maximize the ability to recover from hard disk crashes. 

The underlying concept of RAID is that data may be distributed across each drive in the array in 
a consistent manner. To do this, the data must first be broken into consistently-sized chunks 
(often 32K or 64K in size, although different sizes can be used). Each chunk is then written to a 
hard drive in the RAID array according to the RAID level used. When the data is to be read, the 
process is reversed, giving the illusion that the multiple drives in the array are actually one large 
drive. 

2. Who Should Use RAID? 

Those who need to keep large quantities of data on hand (such as system administrators) 
would benefit by using RAID technology. Primary reasons to use RAID include: 



• Enhanced speed 

• Increased storage capacity using a single virtual disk 

• Lessened impact of a disk failure 

3. Hardware RAID versus Software RAID 

There are two possible RAID approaches: Hardware RAID and Software RAID. 

3.1. Hardware RAID 

The hardware-based array manages the RAID subsystem independently from the host and 
presents to the host only a single disk per RAID array. 

An example of a Hardware RAID device would be one that connects to a SCSI controller and 
presents the RAID arrays as a single SCSI drive. An external RAID system moves all RAID 
handling "intelligence" into a controller located in the external disk subsystem. The whole 
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subsystem is connected to the host via a normal SCSI controller and appears to the host as a 
single disk. 

RAID controllers also come in the form of cards that act like a SCSI controller to the operating 
system but handle all of the actual drive communications themselves. In these cases, you plug 
the drives into the RAID controller just like you would a SCSI controller, but then you add them 
to the RAID controller's configuration, and the operating system never knows the difference. 

3.2. Software RAID 

Software RAID implements the various RAID levels in the kernel disk (block device) code. It 
offers the cheapest possible solution, as expensive disk controller cards or hot-swap chassis 1 
are not required. Software RAID also works with cheaper IDE disks as well as SCSI disks. With 
today's fast CPUs, Software RAID performance can excel against Hardware RAID. 

The MD driver in the Linux kernel is an example of a RAID solution that is completely hardware 
independent. The performance of a software-based array is dependent on the server CPU 
performance and load. 

For information on configuring Software RAID during installation, refer to the Chapter 10, 
Software RAID Configuration. 

For those interested in learning more about what Software RAID has to offer, here are the most 
important features: 



• Threaded rebuild process 

• Kernel-based configuration 

• Portability of arrays between Linux machines without reconstruction 

• Backgrounded array reconstruction using idle system resources 

• Hot-swappable drive support 

• Automatic CPU detection to take advantage of certain CPU optimizations 

4. RAID Levels and Linear Support 

RAID supports various configurations, including levels 0, 1, 4, 5, and linear. These RAID types 
are defined as follows: 



• Level — RAID level 0, often called "striping," is a performance-oriented striped data 



1 A hot-swap chassis allows you to remove a hard drive without having to power-down your system. 
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mapping technique. This means the data being written to the array is broken down into strips 
and written across the member disks of the array, allowing high I/O performance at low 
inherent cost but provides no redundancy. The storage capacity of a level array is equal to 
the total capacity of the member disks in a Hardware RAID or the total capacity of member 
partitions in a Software RAID. 

• Level 1 — RAID level 1 , or "mirroring," has been used longer than any other form of RAID. 
Level 1 provides redundancy by writing identical data to each member disk of the array, 
leaving a "mirrored" copy on each disk. Mirroring remains popular due to its simplicity and 
high level of data availability. Level 1 operates with two or more disks that may use parallel 
access for high data-transfer rates when reading but more commonly operate independently 
to provide high I/O transaction rates. Level 1 provides very good data reliability and improves 
performance for read-intensive applications but at a relatively high cost. 2 The storage 
capacity of the level 1 array is equal to the capacity of one of the mirrored hard disks in a 
Hardware RAID or one of the mirrored partitions in a Software RAID. 

• Level 4 — Level 4 uses parity 3 concentrated on a single disk drive to protect data. It is better 
suited to transaction I/O rather than large file transfers. Because the dedicated parity disk 
represents an inherent bottleneck, level 4 is seldom used without accompanying technologies 
such as write-back caching. Although RAID level 4 is an option in some RAID partitioning 
schemes, it is not an option allowed in Red Hat Enterprise Linux RAID installations. 4 The 
storage capacity of Hardware RAID level 4 is equal to the capacity of member disks, minus 
the capacity of one member disk. The storage capacity of Software RAID level 4 is equal to 
the capacity of the member partitions, minus the size of one of the partitions if they are of 
equal size. 

• Level 5 — This is the most common type of RAID. By distributing parity across some or all of 
an array's member disk drives, RAID level 5 eliminates the write bottleneck inherent in level 4. 
The only performance bottleneck is the parity calculation process. With modern CPUs and 
Software RAID, that usually is not a very big problem. As with level 4, the result is 
asymmetrical performance, with reads substantially outperforming writes. Level 5 is often 
used with write-back caching to reduce the asymmetry. The storage capacity of Hardware 
RAID level 5 is equal to the capacity of member disks, minus the capacity of one member 
disk. The storage capacity of Software RAID level 5 is equal to the capacity of the member 
partitions, minus the size of one of the partitions if they are of equal size. 

• Linear RAID — Linear RAID is a simple grouping of drives to create a larger virtual drive. In 
linear RAID, the chunks are allocated sequentially from one member drive, going to the next 
drive only when the first is completely filled. This grouping provides no performance benefit, 
as it is unlikely that any I/O operations will be split between member drives. Linear RAID also 
offers no redu ndancy and, in fact, decreases reliability — if any one member drive fails, the 

■in the array, which 

wastes drive space. For example, if you have RAID level 1 set up so that your root (/) partition exists on two 40G 
drives, you have 80G total but are only able to access 40G of that 80G. The other 40G acts like a mirror of the first 40G. 

3 Parity information is calculated based on the contents of the rest of the member disks in the array. This information 
can then be used to reconstruct data when one disk in the array fails. The reconstructed data can then be used to 
satisfy I/O requests to the failed disk before it is replaced and to repopulate the failed disk after it has been replaced. 

4 RAID level 4 takes up the same amount of space as RAID level 5, but level 5 has more advantages. For this reason, 
level 4 is not supported. 
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Software RAID Configuration 

Software RAID can be configured during the graphical installation process, the text-based 
installation process, or during a kickstart installation. This chapter discusses how to configure 
software RAID during installation, using the Disk Druid interface. 

Read Chapter 9, Redundant Array of Independent Disks (RAID) first to learn about RAID, the 
differences between hardware and software RAID, and the differences between RAID 0, 1, and 
5. An overview of the steps required to configure RAID include: 



• Applying software RAID partitions to the physical hard drives. 

If you wish to have the boot partition (/boot/) reside on a RAID parition, it mustbe on a RAID 
1 partition. 

• Creating RAID cfev/'ces from the software RAID partitions. 

• Optional: Configuring L VM from the RAIDdevices. Referto Chapter8, LVM Configuration for 
more information on configuring LVM after first configuring RAID. 

• Creating file systems from the RAID devices. 



Note 

Although the following steps are illustrated during a GUI installation, the same 
can be done during a text-based installation. 

Configuration of software RAID must be done manually in Disk Druid during the 
installation process. 



Two 9.1 GB SCSI drives (/dev/sda and /dev/sdb) are used in the following examples. They 
detail how to create a simple RAID 1 configuration by implementing multiple RAID devices. 

On the Disk Partitioning Setup screen, select Manually partition with Disk Druid. 

1. Creating the RAID Partitions 

In a typical situation, the disk drives are new or are formatted. Both drives are shown as raw 
devices with no partition configuration in Figure 10. 1, "Two Blank Drives, Ready For 
Configuration". 
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Figure 10.1. Two Blank Drives, Ready For Configuration 



1 . In Disk Druid, choose RAID to enter the software RAID creation screen. 

2. Choose Create a software RAID partition to create a RAID partition as shown in 
Figure 10.2, "RAID Partition Options". Note that no other RAID options (such as entering a 
mount point) are available until RAID partitions, as well as RAID devices, are created. 
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RAID Options 



Software RAID allows you to combine several disks into a 
larger RAID device. A RAID device can be configured to 
provide additional speed and reliability compared to using an 
individual drive. For more information on using RAID devices 
please consult the Red Hat Enterprise Linux AS 
documentation. 

You currently have software RAID partition(s) free to use. 

To use RAID you must first create at least two partitions of 
type 'software RAID 1 . Then you can create a RAID device 
which can be formatted and mounted. 

What do you want to do now? 



® jCreate a software RAID partition. 



O Create a RAID device [default=/dev/mdQ]. 



O Clone a drive to create a RAID device [default=/dev/mdO]. 



X Cancel 



Figure 10.2. RAID Partition Options 



3. A software RAID partition must be constrained to one drive. For Allowable Drives, select the 
drive on which RAID is to be created. If you have multiple drives, all drives are selected, and 
you must deselect all but one drive. 
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Add Partition 



Mount Paint: 
File System XVP e: 

Allowable Drives: 



<Not Applicable* 



software RAID 



sda 8676 MB IBM-PSG ST39103LC !# 
□ sdb 8676 MB IBM-PSG ST39204LC !# 
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Size (MB): 

Additional Size Options 
® Fixed size 

O Fill all space up to (MB): 

O Fill to maximum .allowable size 




Figure 10.3. Adding a RAID Partition 



4. Enter the size that you want the partition to be. 

5. Select Fixed size to make the partition the specified size, select Fill all space up to (MB) 
and enter a size in MBs to give range for the partition size, or select Fill to maximum 
allowable size to make it grow to fill all available space on the hard disk. If you make more 
than one partition growable, they share the available free space on the disk. 

6. Select Force to be a primary partition if you want the partition to be a primary partition. A 
primary partition is one of the first four partitions on the hard drive. If unselected, the partition 
is created as a logical partition. If other operating systems are already on the system, 
unselecting this option should be considered. For more information on primary versus 
logical/extended partitions, refer to the appendix section of the Red Hat Enterprise Linux 
Installation Guide. 



7. Click OK to return to the main screen. 



Repeat these steps to create as many partitions as needed for your RAID setup. Notice that all 
the partitions do not have to be RAID partitions. For example, you can configure only the 
/boot/ partition as a software RAID device, leaving the root partition (/), /home/, and swap as 
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regular file systems. Figure 10.4, "RAID 1 Partitions Ready, Pre-Device and Mount Point 
Creation" shows successfully allocated space for the RAID 1 configuration (for /boot/), which is 
now ready for RAID device and mount point creation: 



Disk Setup 



Choose where you would like 
Red Hat Enterprise Linux AS to 
be installed. 

If you do not know how to 
partition your system or if you 
need help with using the 
manual partitioning tools, refer 
to the product documentation. 

If you used automatic 
partitioning, you can either 
accept the current partition 
settings (click Next), or modify 
the setup using the manual 
partitioning tool. 

If you are manually partitioning 
your system, you can see your 
current hard drive(s) and 
partitions displayed below. Use 
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Hard Drives 
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/dev/sdal 

Free 
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Mount Point/ 
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Type 
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Free space 
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Free space 



Format 
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□ Hide RAID device/LVM Volume .Group members 



Back 



► Next 



Figure 10.4. RAID 1 Partitions Ready, Pre-Device and Mount Point 
Creation 



2. Creating the RAID Devices and Mount Points 

Once you have all of your partitions created as software RAID partitions, the following steps 
create the RAID device and mount point: 



1 . Select the RAID button on the Disk Druid main partitioning screen (refer to Figure 10.5, 
"RAID Options'). 

2. Figure 10.5, "RAID Options" appears. Select Create a RAID device. 
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RAID Options 



Software RAID allows you to combine several disks into a 
larger RAID device. A RAID device can be configured to 
provide additional speed and reliability compared to using an 
individual drive. For more information on using RAID devices 
please consult the Red Hat Enterprise Linux AS documentation. 

You currently have 3 software RAID partition(s) free to use. 

What do you want to do now? 

Q Create a software RAID partition. 



':«:■! Create a RAID device [defaulted ev/mdO]. 



O Clone a chive to create a RAID device [default=/dev/mdO]. 



Cancel 



4 OK 



Figure 10.5. RAID Options 



3. Next, Figure 10.6, "Making a RAID Device and Assigning a Mount Point" appears, where you 
can make a RAID device and assign a mount point. 
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Make RAID Devi 



Mount Point: 
File SystemXVP e: 
RAID Device: 
RAID Level: 

RAID Members: 
Number of .spares: 
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^boot 
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ext3 
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4 OK 



Figure 10.6. Making a RAID Device and Assigning a Mount Point 



4. Enter a mount point. 

5. Choose the file system type for the partition. At this point you can either configure a dynamic 
LVM file system or a traditional static ext2/ext3 file system. For more information on 
configuring LVM on a RAID device, select physical volume (LVM) and then refer to 
Chapter 8, LVM Configuration. If LVM is not required, continue on with the following 
instructions. 

6. Select a device name such as mdO for the RAID device. 

7. Choose your RAID level. You can choose from RAID 0, RAID 1 , and RAID 5. If you need 
assistance in determining which RAID level to implement, refer to Chapter 9, Redundant 
Array of Independent Disks (RAID). 



i 



Note 
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If you are making a RAID partition of /boot/, you must choose RAID level 1 , and 
it must use one of the first two drives (IDE first, SCSI second). If you are not 
creating a seperate RAID partition of /boot/, and you are making a RAID 
partition for the root file system (/), it must be RAID level 1 and must use one of 
the first two drives (IDE first, SCSI second). 








l^^jjj) Bootable partitions can only be on RAID1 devices. 


Figure 10.7. The /boot/ Mount Error 



8. The RAID partitions created appear in the RAID Members list. Select which of these 
partitions should be used to create the RAID device. 

9. If configuring RAID 1 or RAID 5, specify the number of spare partitions. If a software RAID 
partition fails, the spare is automatically used as a replacement. For each spare you want to 
specify, you must create an additional software RAID partition (in addition to the partitions for 
the RAID device). Select the partitions for the RAID device and the partition(s) for the 
spare(s). 

10After clicking OK, the RAID device appears in the Drive Summary list. 

1 1 Repeat this chapter's entire process for configuring additional partitions, devices, and mount 
points, such as the root partition (/), /home/, or swap. 

After completing the entire configuration, the figure as shown in Figure 10.8, "Final Sample 
RAID Configuration" resembles the default configuration, except for the use of RAID. 
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Disk Setup 

Choose where you would like 
Red Hat Enterprise Linux AS to 
be installed. 

If you do not know how to 
partition your system or if you 
need help with using the 
manual partitioning tools, refer 
to the product documentation. 

If you used automatic 
partitioning, you can either 
accept the current partition 
settings (click Next), or modify 
the setup using the manual 
partitioning tool. 

If you are manually partitioning 
your system, you can see your 
current hard drive(s) and 
partitions displayed below. Use 
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Figure 10.8. Final Sample RAID Configuration 



The figure as shown in Figure 10.9, "Final Sample RAID With LVM Configuration" Is an example 
of a RAID and LVM configuration. 
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redhat. 



Disk Setup 
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Red Hat Enterprise Linux AS to 
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If you do not know haw to 
partition your system or if you 
need help with using the 
manual partitioning tools, refer 
to the product documentation. 

If you used automatic 
partitioning, you can either 
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settings (click Next), or modify 
the setup using the manual 
partitioning tool. 

If you are manually partitioning 
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Figure 10.9. Final Sample RAID With LVM Configuration 



You can continue with your installation process. Refer to the Red Hat Enterprise Linux 
Installation Guide tor further instructions. 
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Swap Space 

1 . What is Swap Space? 

Swap space in Linux is used when the amount of physical memory (RAM) is full. If the system 
needs more memory resources and the RAM is full, inactive pages in memory are moved to the 
swap space. While swap space can help machines with a small amount of RAM, it should not 
be considered a replacement for more RAM. Swap space is located on hard drives, which have 
a slower access time than physical memory. 

Swap space can be a dedicated swap partition (recommended), a swap file, or a combination of 
swap partitions and swap files. 

The size of your swap should be equal to twice your computer's physical RAM for up to 2 GB of 
physical RAM. For physical RAM above 2 GB, the size of your swap should be equal to the 
amount of physical RAM above 2 GB. The size of your swap should never be less than 32 MB. 

Using this basic formula, a system with 2 GB of physical RAM would have 4 GB of swap, while 
one with 3 GB of physical RAM would have 5 GB of swap. 



Note 

Unfortunately, deciding on the amount of swap to allocate to Red Hat Enterprise 
Linux is more of an art than a science, so hard rules are not possible. Each 
system's most used applications should be accounted for when determining 
swap size. 



Important 

File systems and LVM2 volumes assigned as swap space cannot be in use when 
being modified. For example, no system processes can be assigned the swap 
space, as well as no amount of swap should be allocated and used by the kernel. 

Use the free and cat /proc/swaps commands to verify how much and where 
swap is in use. 

The best way to achieve swap space modifications is to boot your system in 
rescue mode, and then follow the instructions (for each scenario) in the 
remainder of this chapter. Refer to Chapter 5, Basic System Recovery tor 
instructions on booting into rescue mode. When prompted to mount the file 
system, select Skip. 



2. Adding Swap Space 
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Sometimes it is necessary to add more swap space after installation. For example, you may 
upgrade the amount of RAM in your system from 128 MB to 256 MB, but there is only 256 MB 
of swap space. It might be advantageous to increase the amount of swap space to 512 MB if 
you perform memory-intense operations or run applications that require a large amount of 
memory. 

You have three options: create a new swap partition, create a new swap file, or extend swap on 
an existing LVM2 logical volume. It is recommended that you extend an existing logical volume. 

2.1. Extending Swap on an LVM2 Logical Volume 

To extend an LVM2 swap logical volume (assuming /dev/voiGroupOO/Logvoioi is the volume 
you want to extend): 

1 . Disable swapping for the associated logical volume: 

# swapoff -v /dev/VolGroupOO/LogVolOl 

2. Resize the LVM2 logical volume by 256 MB: 

# lvm lvresize /dev/VolGroupOO/LogVolOl -L +256M 

3. Format the new swap space: 

# mkswap /dev/VolGroupOO/LogVolOl 

4. Enable the extended logical volume: 

# swapon -va 

5. Test that the logical volume has been extended properly: 

# cat /proc/swaps # free 

2.2. Creating an LVM2 Logical Volume for Swap 

To add a swap volume group (assuming /dev/voiGroupOO/Logvoi02 is the swap volume you 
want to add): 



1 . Create the LVM2 logical volume of size 256 MB: 
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# lvm lvcreate VolGroupOO -n LogVol02 -L 256M 

2. Format the new swap space: 

# mkswap /dev/VolGroupOO/LogVol02 

3. Add the following entry to the /eto/f stab file: 

/dev/VolGroupOO/LogVol02 swap swap defaults 

4. Enable the extended logical volume: 

# swapon -va 

5. Test that the logical volume has been extended properly: 

# cat /proc/swaps # free 

2.3. Creating a Swap File 

To add a swap file: 

1 . Determine the size of the new swap file in megabytes and multiply by 1 024 to determine the 
number of blocks. For example, the block size of a 64 MB swap file is 65536. 

2. At a shell prompt as root, type the following command with count being equal to the desired 
block size: 

dd if=/dev/zero of=/swapfile bs=1024 count=65536 

3. Setup the swap file with the command: 

mkswap /swapfile 

4. To enable the swap file immediately but not automatically at boot time: 

swapon /swapfile 

5. To enable it at boot time, edit /etc/f stab to include the following entry: 
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/swapfile swap swap defaults 

The next time the system boots, it enables the new swap file. 

6. After adding the new swap file and enabling it, verify it is enabled by viewing the output of the 
command cat /proc/ swaps Or tree. 

3. Removing Swap Space 

Sometimes it can be prudent to reduce swap space after installation. For example, say you 
downgraded the amount of RAM in your system from 1 GB to 51 2 MB, but there is 2 GB of 
swap space still assigned. It might be advantageous to reduce the amount of swap space to 1 
GB, since the larger 2 GB could be wasting disk space. 

You have three options: remove an entire LVM2 logical volume used for swap, remove a swap 
file, or reduce swap space on an existing LVM2 logical volume. 

3.1. Reducing Swap on an LVM2 Logical Volume 

To reduce an LVM2 swap logical volume (assuming /dev/voiGroupOO/Logvoioi is the volume 
you want to extend): 

1. Disable swapping for the associated logical volume: 

# swapoff -v /dev/VolGroupOO/LogVolOl 

2. Reduce the LVM2 logical volume by 512 MB: 

# lvm lvreduce /dev/VolGroupOO/LogVolOl -L -512M 

3. Format the new swap space: 

# mkswap /dev/VolGroupOO/LogVolOl 

4. Enable the extended logical volume: 

# swapon -va 

5. Test that the logical volume has been reduced properly: 

# cat /proc/swaps # free 
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3.2. Removing an LVM2 Logical Volume for Swap 

The swap logical volume cannot be in use (no system locks or processes on the volume). The 
easiest way to achieve this it to boot your system in rescue mode. Refer to Chapter 5, Basic 
System Recovery tor instructions on booting into rescue mode. When prompted to mount the 
file system, select Skip. 

To remove a swap volume group (assuming /dev/voiGroupOO/Logvoi02 is the swap volume 
you want to remove): 

1 . Disable swapping for the associated logical volume: 

# swapoff -v /dev/VolGroupOO/LogVol02 

2. Remove the LVM2 logical volume of size 512 MB: 

# lvm lvremove /dev/VolGroupOO/LogVol02 

3. Remove the following entry from the /etc/f stab file: 

/dev/VolGroupOO/LogVol02 swap swap defaults 

4. Test that the logical volume has been extended properly: 

# cat /proc/swaps # free 

3.3. Removing a Swap File 

To remove a swap file: 

1 . At a shell prompt as root, execute the following command to disable the swap file (where 

/swapf iie is the swap file): 

# swapoff -v /swapfile 

2. Remove its entry from the /etc/f stab file. 

3. Remove the actual file: 

# rm / swapfile 
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4. Moving Swap Space 

To move swap space from one location to another, follow the steps for removing swap space, 
and then follow the steps for adding swap space. 
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Managing Disk Storage 

Introduction to different methods 

1. Standard Partitions using parted 

Many users need to view the existing partition table, change the size of the partitions, remove 
partitions, or add partitions from free space or additional hard drives. The utility parted allows 
users to perform these tasks. This chapter discusses how to use parted to perform file system 
tasks. 

If you want to view the system's disk space usage or monitor the disk space usage, refer to 
Section 3, "File Systems". 

You must have the parted package installed to use the parted utility. To start parted, at a 
shell prompt as root, type the command parted /dev/sda, where /dev/sda is the device name 
for the drive you want to configure. The (parted) prompt is displayed. Type help to view a list 
of available commands. 

If you want to create, remove, or resize a partition, the device cannot be in use (partitions 
cannot be mounted, and swap space cannot be enabled). The partition table should not be 
modified while in use because the kernel may not properly recognize the changes. Data could 
be overwritten by writing to the wrong partition because the partition table and partitions 
mounted do not match. The easiest way to achieve this it to boot your system in rescue mode. 
Refer to Chapter 5, Basic System Recovery tor instructions on booting into rescue mode. When 
prompted to mount the file system, select Skip. 

Alternately, if the drive does not contain any partitions in use (system processes that use or lock 
the file system from being unmounted), you can unmount them with the umount command and 
turn off all the swap space on the hard drive with the swapof f command. 



Table 12. 1, "parted commands" contains a list of commonly used parted commands. The 
sections that follow explain some of them in more detail. 



Command 


Description 


check minor-num 


Perform a simple check of the file system 


cp fromto 


Copy file system from one partition to another; 
from and to are the minor numbers of the 
partitions 


help 


Display list of available commands 


mklabel label 


Create a disk label for the partition table 


mkfs mlnor-numfile-sy stem-type 


Create a file system of type 

file-system-type 


mkpart part-type fs -type start -mbend-mb 


Make a partition without creating a new file 
system 
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Command 


Description 


mkpartf s 

part -typefs-typestart-mbend-mb 


■LJII J. " J. " 1 _ j_ _ i 1 ^ _ " _ _l r ■ 1 

Make a partition and create the specified file 
system 


move minor-numstart-mbend-mb 


Move the partition 


name minor -numname 


Name the partition for Mac and PC98 
disklabels only 


print 


Display the partition table 


quit 


Quit parted 


re s cue s t art -mbend-mb 


Rescue a lost partition from start-mb to 

end-mb 


resize minor-numstart-mbend-mb 


Resize the partition from start-mb tO end-mb 


rm minor-num 


Remove the partition 


select device 


Select a different device to configure 


set minor-numflagstate 


Set the flag on a partition; state is either on 
or off 



Table 12.1 . parted commands 



1.1. Viewing the Partition Table 

After starting parted, type the following command to view the partition table: 

print 



A table similar to the following appears: 



Disk 


geometry for 


/ dev/sda : 


0.000-8678 


.78 9 megabytes 


Disk 


label type: 


msdos 






Minor 


Start 


End 


Type 


Filesystem Flags 


1 


. 031 


101 . 975 


primary 


ext3 boot 


2 


101 . 975 


5098.754 


primary 


ext3 


3 


5098 . 755 


6361 . 677 


primary 


linux-swap 


4 


6361 . 677 


8675.727 


extended 




5 


6361 . 708 


7357.895 


logical 


ext3 


Disk 


geometry for 


/dev/hda : 


0.000-9765 


.4 92 megabytes 


Disk 


label type: 


msdos 






Minor 


Start 


End 


Type 


Filesystem Flags 


1 


. 031 


101 . 975 


primary 


ext3 boot 


2 


101 . 975 


611.850 


primary 


linux-swap 


3 


611.851 


760.891 


primary 


ext3 


4 


760 .891 


9758.232 


extended 


lba 


5 


760 . 922 


9758.232 


logical 


ext3 
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The first line displays the size of the disk, the second line displays the disk label type, and the 
remaining output shows the partition table. 

In the partition table, the Minor number is the partition number. For example, the partition with 
minor number 1 corresponds to /dev/sdai. The Start and End values are in megabytes. The 
Type is one of primary, extended, or logical. The Filesystem is the file system type, which can 
be one of ext2, ext3, fat16, fat32, hfs, jfs, linux-swap, ntfs, reiserfs, hp-ufs, sun-ufs, or xfs. The 
Flags column lists the flags set for the partition. Available flags are boot, root, swap, hidden, 
raid, Ivm, or Iba. 

In this example, minor number 1 refers to the /boot / file system, minor number 2 refers to the 
root file system (/), minor number 3 refers to the swap, and minor number 5 refers to the 
/home/ file system. 



To select a different device without having to restart parted, use the select 
command followed by the device name such as /dev/sda. Then, you can view 
its partition table or configure it. 



1.2. Creating a Partition 



A 



Warning 



Do not attempt to create a partition on a device that is in use. 



Before creating a partition, boot into rescue mode (or unmount any partitions on the device and 
turn off any swap space on the device). 

Start parted, where /dev/sda is the device on which to create the partition: 

parted /dev/sda 



View the current partition table to determine if there is enough free space: 



print 



If there is not enough free space, you can resize an existing partition. Refer to Section 1.4, 
"Resizing a Partition"for details. 
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1.2.1. Making the Partition 

From the partition table, determine the start and end points of the new partition and what 
partition type it should be. You can only have four primary partitions (with no extended partition) 
on a device. If you need more than four partitions, you can have three primary partitions, one 
extended partition, and multiple logical partitions within the extended. For an overview of disk 
partitions, refer to the appendix An Introduction to Disk Partitions in the Red Hat Enterprise 
Linux Installation Guide. 

For example, to create a primary partition with an ext3 file system from 1 024 megabytes until 
2048 megabytes on a hard drive type the following command: 

mkpart primary ext3 1024 2048 



Tip 

If you use the mkpartfs command instead, the file system is created after the 
partition is created. However, parted does not support creating an ext3 file 
system. Thus, if you wish to create an ext3 file system, use mkpart and create 
the file system with the mkf s command as described later, mkpartfs works for 
file system type linux-swap. 



The changes start taking place as soon as you press Enter, so review the command before 
executing to it. 

After creating the partition, use the print command to confirm that it is in the partition table with 
the correct partition type, file system type, and size. Also remember the minor number of the 
new partition so that you can label it. You should also view the output of 

cat /proc/partitions 



to make sure the kernel recognizes the new partition. 

1.2.2. Formating the Partition 

The partition still does not have a file system. Create the file system: 

/sbin/mkfs -t ext3 /dev/sda6 
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Formatting the partition permanently destroys any data that currently exists on 
the partition. 



1.2.3. Labeling the Partition 

Next, give the partition a label. For example, if the new partition is /dev/sda6 and you want to 
label it /work: 

e21abel /dev/sda6 /work 

By default, the installation program uses the mount point of the partition as the label to make 
sure the label is unique. You can use any label you want. 

1.2.4. Creating the Mount Point 

As root, create the mount point: 

mkdir /work 

1.2.5. Add to /etc/f stab 

As root, edit the /etc/f stab file to include the new partition. The new line should look similar to 
the following: 

LABEL=/work /work ext3 defaults 1 2 

The first column should contain label= followed by the label you gave the partition. The second 
column should contain the mount point for the new partition, and the next column should be the 
file system type (for example, ext3 or swap). If you need more information about the format, 
read the man page with the command man f stab. 

If the fourth column is the word defaults, the partition is mounted at boot time. To mount the 
partition without rebooting, as root, type the command: 

mount /work 

1.3. Removing a Partition 
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Warning 

Do not attempt to remove a partition on a device that is in use. 



Before removing a partition, boot into rescue mode (or unmount any partitions on the device 
and turn off any swap space on the device). 

Start parted, where /dev/sda is the device on which to remove the partition: 



parted /dev/sda 



View the current partition table to determine the minor number of the partition to remove: 



print 



Remove the partition with the command rm. For example, to remove the partition with minor 
number 3: 



rm 3 



The changes start taking place as soon as you press Enter, so review the command before 
committing to it. 

After removing the partition, use the print command to confirm that it is removed from the 
partition table. You should also view the output of 

cat /proc/partitions 



to make sure the kernel knows the partition is removed. 

The last step is to remove it from the /etc/f stab file. Find the line that declares the removed 
partition, and remove it from the file. 

1.4. Resizing a Partition 




Warning 

Do not attempt to resize a partition on a device that is in use. 



Before resizing a partition, boot into rescue mode (or unmount any partitions on the device and 
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turn off any swap space on the device). 

Start parted, where /dev/sda is the device on which to resize the partition: 

parted /dev/sda 



View the current partition table to determine the minor number of the partition to resize as well 
as the start and end points for the partition: 



print 



A 



Warning 

The used space of the partition to resize must not be larger than the new size. 



To resize the partition, use the resize command followed by the minor number for the partition, 
the starting place in megabytes, and the end place in megabytes. For example: 



resize 3 1024 2048 



After resizing the partition, use the print command to confirm that the partition has been 
resized correctly, is the correct partition type, and is the correct file system type. 

After rebooting the system into normal mode, use the command df to make sure the partition 
was mounted and is recognized with the new size. 

2. LVM Partition Management 



The following commands can be found by issuing lvm help at a command prompt. 



Command 


Description 


dumpconf ig 


Dump the active configuration 


formats 


List the available metadata formats 


help 


Display the help commands 


lvchange 


Change the attributes of logical volume(s) 


Ivcreate 


Create a logical volume 


lvdisplay 


Display information about a logical volume 


lvextend 


Add space to a logical volume 


Ivmchange 


Due to use of the device mapper, this 
command has been deprecated 
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Command 


Description 


lvmdiskscan 


List devices that may be used as physical 
volumes 


lvmsadc 


Collect activity data 


lvmsar 


Create activity report 


lvreduce 


Reduce the size of a logical volume 


lvremove 


Remove logical volume(s) from the system 


lvrename 


Rename a logical volume 


lvresi ze 


Resize a logical volume 


lvs 


Display information about logical volumes 


lvscan 


List all logical volumes in all volume groups 


pvchange 


Change attributes of physical volume(s) 


pvcreate 


Initialize physical volume(s) for use by LVM 


pvdata 


Display the on-disk metadata for physical 
volume(s) 


pvdisplay 


Display various attributes of physical 
volume(s) 


pvmove 


Move extents from one physical volume to 
another 


pvremove 


Remove LVM label(s) from physical volume(s) 


pvres i ze 


Resize a physical volume in use by a volume 
group 


pvs 


Display information about physical volumes 


pvscan 


List all physical volumes 


segtypes 


List available segment types 


vgcf gbackup 


Backup volume group configuration 


vgcf gr est ore 


Restore volume group configuration 


vgchange 


Change volume group attributes 


vgck 


Check the consistency of a volume group 


vgconvert 


Change volume group metadata format 


vgcreate 


Create a volume group 


vgdisplay 


Display volume group information 


vgexport 


Unregister a volume group from the system 


vgextend 


Add physical volumes to a volume group 


vgimport 


Register exported volume group with system 


vgmerge 


Merge volume groups 


vgmknodes 


Create the special files for volume group 
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Command 


Description 




devices in /dev/ 


vgreduce 


Remove a physical volume from a volume 
arouD 


vgremove 


Remove a volume group 


vgrename 


Rename a volume group 


vgs 


Display information about volume groups 


vgscan 


Search for all volume groups 


vgsplit 


Move physical volumes into a new volume 
group 


version 


Display software and driver version 
information 



Table 12.2. lvm commands 
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Implementing Disk Quotas 

Disk space can be restricted by implementing disk quotas which alert a system administrator is 
alerted before a user consumes too much disk space or a partition becomes full. 

Disk quotas can be configured for individual users as well as user groups. This kind of flexibility 
makes it possible to give each user a small quota to handle "personal" files (such as email and 
reports), while allowing the projects they work on to have more sizable quotas (assuming the 
projects are given their own groups). 

In addition, quotas can be set not just to control the number of disk blocks consumed but to 
control the number of inodes (data structures that contain information about files in UNIX file 
systems). Because inodes are used to contain file-related information, this allows control over 
the number of files that can be created. 

The quota RPM must be installed to implement disk quotas. 

1. Configuring Disk Quotas 

To implement disk quotas, use the following steps: 



1. Enable quotas per file system by modifying the /etc/fstab file. 

2. Remount the file system(s). 

3. Create the quota database files and generate the disk usage table. 

4. Assign quota policies. 

Each of these steps is discussed in detail in the following sections. 

1.1. Enabling Quotas 



As root, using a text editor, edit the /etc/fstab file. Add the usrquota and/or grpquota options 
to the file systems that require quotas: 



/dev/VolGroupOO/LogVolOO 


/ 


ext3 


defaults 


1 


1 


LABEL=/boot 


/boot 


ext3 


defaults 


1 


2 


none 


/ dev/pts 


devpts 


gid=5, mode=620 





none 


/dev/ shm 


tmpf s 


defaults 








none 


/proc 


proc 


defaults 








none 


/sys 


sysf s 


defaults 








/dev/VolGroupOO/LogVol02 


/home 


ext3 


defaults, 


usrquota, 


grpquota 1 2 


/dev/VolGroupOO/LogVolOl 


swap 


swap 


defaults 
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In this example, the /home file system has both user and group quotas enabled. 



Note 

The following examples assume that a separate /home partition was created 
during the installation of Red Hat Enterprise Linux. Although not ideal, the root 
(/) partition (the installation default created partition) can be used for setting 
quota policies in the /etc/f stab file. 



1.2. Remounting the File Systems 

After adding the usrquota and/or grpquota options, remount each file system whose f stab 
entry has been modified. If the file system is not in use by any process, use one of the following 
methods: 



• Issue the umount command followed by the mount command to remount the file system. 

• ISSUe the mount -o remount /home command to remount the file system. 

If the file system is currently in use, the easiest method for remounting the file system is to 
reboot the system. 

1.3. Creating the Quota Database Files 

After each quota-enabled file system is remounted, the system is capable of working with disk 
quotas. However, the file system itself is not yet ready to support quotas. The next step is to run 

the quotacheck command. 

The quotacheck command examines quota-enabled file systems and builds a table of the 
current disk usage per file system. The table is then used to update the operating system's copy 
of disk usage. In addition, the file system's disk quota files are updated. 

To create the quota files (aquota .user and aquota . group) on the file system, use the -c 
option of the quotacheck command. For example, if user and group quotas are enabled for the 
/home file system, create the files in the /home directory: 

quotacheck -cug /home 

The -c option specifies that the quota files should be created for each file system with quotas 
enabled, the -u option specifies to check for user quotas, and the -g option specifies to check 
for group quotas. 

If neither the -u or -g options are specified, only the user quota file is created. If only -g is 
specified, only the group quota file is created. 
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After the files are created, run the following command to generate the table of current disk 
usage per file system with quotas enabled: 

quotacheck -avug 

The options used are as follows: 

• a — Check all quota-enabled, locally-mounted file systems 

• v — Display verbose status information as the quota check proceeds 

• u — Check user disk quota information 

• g — Check group disk quota information 

After quotacheck has finished running, the quota files corresponding to the enabled quotas 
(user and/or group) are populated with data for each quota-enabled locally-mounted file system 

SUCh as /home. 

1.4. Assigning Quotas per User 

The last step is assigning the disk quotas with the edquota command. 

To configure the quota for a user, as root in a shell prompt, execute the command: 

edquota username 

Perform this step for each user who needs a quota. For example, if a quota is enabled in 

/etc/f stab for the /home partition (/dev/VolGroupOO/LogVol02) and the command edquota 

testuser is executed, the following is shown in the editor configured as the default for the 
system: 



Disk quotas for user testuser (uid 501) : 










Filesystem blocks soft 


hard 


inodes 


soft 


hard 


/dev/VolGroupOO/LogVol02 440436 





37418 










Note 



The text editor defined by the editor environment variable is used by edquota. 
To change the editor, set the editor environment variable in your 
-/ .bash_prof iie file to the full path of the editor of your choice. 
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The first column is the name of the file system that has a quota enabled for it. The second 
column shows how many blocks the user is currently using. The next two columns are used to 
set soft and hard block limits for the user on the file system. The inodes column shows how 
many inodes the user is currently using. The last two columns are used to set the soft and hard 
inode limits for the user on the file system. 

A hard limit is the absolute maximum amount of disk space that a user or group can use. Once 
this limit is reached, no further disk space can be used. 

The soft limit defines the maximum amount of disk space that can be used. However, unlike the 
hard limit, the soft limit can be exceeded for a certain amount of time. That time is known as the 
grace period. The grace period can be expressed in seconds, minutes, hours, days, weeks, or 
months. 



If any of the values are set to 0, that limit is not set. In the text editor, change the desired limits. 
For example: 



Disk quotas for user testuser (uid 


501) : 










Filesystem blocks 


soft 


hard 


inodes 


soft 


hard 


/dev/VolGroupOO/LogVol02 440436 


500000 


550000 


37418 









To verify that the quota for the user has been set, use the command: 

quota testuser 

1.5. Assigning Quotas per Group 

Quotas can also be assigned on a per-group basis. For example, to set a group quota for the 
devei group (the group must exist prior to setting the group quota), use the command: 

edquota -g devel 



This command displays the existing quota for the group in the text editor: 



Disk quotas for group devel 


(gid 505) : 








Filesystem 


blocks soft 


hard 


inodes 


soft 


hard 










/dev/VolGroup00/LogVol02 


440400 





37418 

















Modify the limits, save the file, and then configure the quota. 
To verify that the group quota has been set, use the command: 
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quota -g devel 



1.6. Assigning Quotas per File System 

To assign quotas based on each file system enabled for quotas, use the command: 

edquota -t 

Like the other edquota commands, this one opens the current quotas for the file system in the 
text editor: 



Grace period before enforcing soft limits for users: 

Time units may be: days, hours, minutes, or seconds 

Filesystem Block grace period Inode grace period 

/dev/mapper/VolGroupOO-LogVol02 7days 7days 



Change the block grace period or inode grace period, save the changes to the file, and exit the 
text editor. 

2. Managing Disk Quotas 

If quotas are implemented, they need some maintenance — mostly in the form of watching to 
see if the quotas are exceeded and making sure the quotas are accurate. Of course, if users 
repeatedly exceeds their quotas or consistently reaches their soft limits, a system administrator 
has a few choices to make depending on what type of users they are and how much disk space 
impacts their work. The administrator can either help the user determine how to use less disk 
space or increase the user's disk quota if needed. 

2.1. Enabling and Disabling 

It is possible to disable quotas without setting them to be 0. To turn all user and group quotas 
off, use the following command: 

quotaoff -vaug 



If neither the -u or -g options are specified, only the user quotas are disabled. If only -g is 
specified, only group quotas are disabled. 

To enable quotas again, use the quotaon command with the same options. 

For example, to enable user and group quotas for all file systems, use the following command: 

quotaon -vaug 
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To enable quotas for a specific file system, such as /home, use the following command: 

quotaon -vug /home 

If neither the -u or -g options are specified, only the user quotas are enabled. If only -g is 
specified, only group quotas are enabled. 

2.2. Reporting on Disk Quotas 



Creating a disk usage report entails running the repquota utility. For example, the command 

repquota /home produces this Output: 



*** Report 


for user quotas on 


device 


/ dev/mapper/VolGroupOO 


-LogVol02 


Block grace 


time: 7days; Inode 


grace 


time: 7days 








Block 


limits 




File limits 


User 


used soft 


hard 


grace used 


soft 


hard grace 


root 


36 





4 








kristin - 


540 
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testuser 


- 440400 500000 


550000 


37418 









To view the disk usage report for all (option -a) quota-enabled file systems, use the command: 

repquota -a 

While the report is easy to read, a few points should be explained. The — displayed after each 
user is a quick way to determine whether the block or inode limits have been exceeded. If either 
soft limit is exceeded, a + appears in place of the corresponding -; the first - represents the 
block limit, and the second represents the inode limit. 

The grace columns are normally blank. If a soft limit has been exceeded, the column contains a 
time specification equal to the amount of time remaining on the grace period. If the grace period 
has expired, none appears in its place. 

2.3. Keeping Quotas Accurate 

Whenever a file system is not unmounted cleanly (due to a system crash, for example), it is 
necessary to run quotacheck. However, quotacheck can be run on a regular basis, even if the 
system has not crashed. Running the following command periodically keeps the quotas more 
accurate (the options used have been described in Section 1.1, "Enabling Quotas'): 



quotacheck -avug 

The easiest way to run it periodically is to use cron. As root, either use the crontab -e 
command to schedule a periodic quotacheck or place a script that runs quotacheck in any one 
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of the following directories (using whichever interval best matches your needs): 

• /etc/cron . hourly 

• /etc/cron . daily 

• /etc/cron . weekly 

• /etc/cron . monthly 

The most accurate quota statistics can be obtained when the file system(s) analyzed are not in 
active use. Thus, the cron task should be schedule during a time where the file system(s) are 
used the least. If this time is various for different file systems with quotas, run quotacheck for 
each file system at different times with multiple cron tasks. 

Refer to Chapter 34, Automated Tasks tor more information about configuring cron. 

3. Additional Resources 

For more information on disk quotas, refer to the following resources. 

3.1. Installed Documentation 

• The quotacheck, edquota, repquota, quota, quotaon, and quotaof f man pages 

3.2. Related Books 

• Red Hat Enterprise Linux Introduction to System Administration ; Red Hat, Inc. — Available at 
http://www.redhat.com/docs/an6 on the Documentation CD, this manual contains background 
information on storage management (including disk quotas) for new Red Hat Enterprise Linux 
system administrators. 
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Access Control Lists 

Files and directories have permission sets for the owner of the file, the group associated with 
the file, and all other users for the system. However, these permission sets have limitations. For 
example, different permissions cannot be configured for different users. Thus, Access Control 
Lists (ACLs) were implemented. 

The Red Hat Enterprise Linux 5.0.0 kernel provides ACL support for the ext3 file system and 
NFS-exported file systems. ACLs are also recognized on ext3 file systems accessed via 
Samba. 

Along with support in the kernel, the aci package is required to implement ACLs. It contains the 
utilities used to add, modify, remove, and retrieve ACL information. 

The cp and mv commands copy or move any ACLs associated with files and directories. 

1. Mounting File Systems 

Before using ACLs for a file or directory, the partition for the file or directory must be mounted 
with ACL support. If it is a local ext3 file system, it can mounted with the following command: 

mount -t ext3 -o acl <device-name><partition> 

For example: 

mount -t ext3 -o acl /dev/VolGroupOO/LogVol02 /work 

Alternatively, if the partition is listed in the /etc/ f stab file, the entry for the partition can include 
the aci option: 

LABEL=/work /work ext3 acl 1 2 

If an ext3 file system is accessed via Samba and ACLs have been enabled for it, the ACLs are 
recognized because Samba has been compiled with the — with-aci-support option. No 
special flags are required when accessing or mounting a Samba share. 

1.1. NFS 

By default, if the file system being exported by an NFS server supports ACLs and the NFS client 
can read ACLs, ACLs are utilized by the client system. 

To disable ACLs on NFS shares when configuring the server, include the no_aci option in the 
/etc/exports file. To disable ACLs on an NFS share when mounting it on a client, mount it 
with the no_aci option via the command line or the /etc/f stab file. 
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2. Setting Access ACLs 

There are two types of ACLs: access ACLs and default ACLs. An access ACL is the access 
control list for a specific file or directory. A default ACL can only be associated with a directory; if 
a file within the directory does not have an access ACL, it uses the rules of the default ACL for 
the directory. Default ACLs are optional. 

ACLs can be configured: 



1 . Per user 

2. Per group 

3. Via the effective rights mask 

4. For users not in the user group for the file 

The setf aci utility sets ACLs for files and directories. Use the -m option to add or modify the 
ACL of a file or directory: 

setfacl — m <rules><files> 

Rules {<ruies>) must be specified in the following formats. Multiple rules can be specified in the 
same command if they are separated by commas. 



u : <uid>: <perms> 

Sets the access ACL for a user. The user name or UID may be specified. The user may be 
any valid user on the system. 

g : <gi d> : <perms> 

Sets the access ACL for a group. The group name or GID may be specified. The group may 
be any valid group on the system. 

m : <perms> 

Sets the effective rights mask. The mask is the union of all permissions of the owning group 
and all of the user and group entries. 

o : <perms> 

Sets the access ACL for users other than the ones in the group for the file. 

White space is ignored. Permissions (< P erms>) must be a combination of the characters r, w , 
and x for read, write, and execute. 

If a file or directory already has an ACL, and the setfacl command is used, the additional rules 
are added to the existing ACL or the existing rule is modified. 

For example, to give read and write permissions to user andrius: 
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setfacl -m u : andrius : rw /pro ject/somef ile 

To remove all the permissions for a user, group, or others, use the -x option and do not specify 
any permissions: 

setfacl -x <rules><files> 

For example, to remove all permissions from the user with UID 500: 

setfacl -x u:500 /pro ject/somef ile 

3. Setting Default ACLs 

To set a default ACL, add d: before the rule and specify a directory instead of a file name. 

For example, to set the default ACL for the /share/ directory to read and execute for users not 
in the user group (an access ACL for an individual file can override it): 

setfacl -m d:o:rx /share 

4. Retrieving ACLs 

To determine the existing ACLs for a file or directory, use the getfacl command: 

getfacl <filename> 

It returns output similar to the following: 

# file: file 

# owner: andrius 

# group: andrius 
user : : rw- 

user : smoore : r — 
group : : r — 
mask : : r — 
other : : r — 



If a directory is specified, and it has a default ACL, the default ACL is also displayed such as: 



# 


file : 


file 


# 


owner : 


: andrius 


# 


group : 


andrius 
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user : : rw- 

user : smoore : r — 

group : : r — 

mask : : r — 

other : : r — 

default : user : : rwx 

default :user:andrius : rwx 

default : group : : r-x 

default : mask : : rwx 

default : other : : r-x 



5. Archiving File Systems With ACLs 



A 



Warning 

The tar and dump commands do not backup ACLs. 



The star utility is similar to the tar utility in that it can be used to generate archives of files; 
however, some of its options are different. Refer to Table 14. 1, "Command Line Options for 
star'for a listing of more commonly used options. For all available options, refer to the star 
man page. The star package is required to use this utility. 



Option 


Description 


-c 


Creates an archive file. 


-n 


Do not extract the files; use in conjunction with -x to 
show what extracting the files does. 


-r 


Replaces files in the archive. The files are written to the 
end of the archive file, replacing any files with the same 
path and file name. 


-t 


Displays the contents of the archive file. 


-u 


Updates the archive file. The files are written to the end 
of the archive if they do not exist in the archive or if the 
files are newer than the files of the same name in the 
archive. This option only work if the archive is a file or 
an unblocked tape that may backspace. 


-x 


Extracts the files from the archive. If used with -u and a 
file in the archive is older than the corresponding file on 
the file system, the file is not extracted. 


-help 


Displays the most important options. 


-xhelp 


Displays the least important options. 


-/ 


Do not strip leading slashes from file names when 
extracting the files from an archive. By default, they are 
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Option 


Description 




striped when files are extracted. 


-acl 


When creating or extracting, archive or restore any 
ACLs associated with the files and directories. 



Table 14.1. Command Line Options for star 



6. Compatibility with Older Systems 

If an ACL has been set on any file on a given file system, that file system has the ext_attr 
attribute. This attribute can be seen using the following command: 

tune2fs -1 <filesystem-device> 

A file system that has acquired the ext_attr attribute can be mounted with older kernels, but 
those kernels do not enforce any ACLs which have been set. 

Versions of the e2f sck utility included in version 1 .22 and higher of the e2f sprogs package 
(including the versions in Red Hat Enterprise Linux 2.1 and 5.0.0) can check a file system with 
the ext_attr attribute. Older versions refuse to check it. 

7. Additional Resources 

Refer to the follow resources for more information. 

7.1. Installed Documentation 

• aci man page — Description of ACLs 

• getfaci man page — Discusses how to get file access control lists 

• setf aci man page — Explains how to set file access control lists 

• star man page — Explains more about the star utility and its many options 

7.2. Useful Websites 

• http://acl.bestbits.at/— Website for ACLs 
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Part III. Package Management 

All software on a Red Hat Enterprise Linux system is divided into RPM packages which can be 
installed, upgraded, or removed. This part describes how to manage the RPM packages on a 
Red Hat Enterprise Linux system using graphical and command line tools. 



Chapter 15. 



Package Management with RPM 

The RPM Package Manager (RPM) is an open packaging system, available for anyone to use, 
which runs on Red Hat Enterprise Linux as well as other Linux and UNIX systems. Red Hat, Inc. 
encourages other vendors to use RPM for their own products. RPM is distributable under the 
terms of the GPL. 

For the end user, RPM makes system updates easy. Installing, uninstalling, and upgrading RPM 
packages can be accomplished with short commands. RPM maintains a database of installed 
packages and their files, so you can invoke powerful queries and verifications on your system. If 
you prefer a graphical interface, you can use the Package Management Tool to perform many 
RPM commands. 

During upgrades, RPM handles configuration files carefully, so that you never lose your 
customizations — something that you cannot accomplish with regular . tar . gz files. 

For the developer, RPM allows you to take software source code and package it into source 
and binary packages for end users. This process is quite simple and is driven from a single file 
and optional patches that you create. This clear delineation between pristine sources and your 
patches along with build instructions eases the maintenance of the package as new versions of 
the software are released. 



Note 

Because RPM makes changes to your system, you must be root to install, 
remove, or upgrade an RPM package. 



1. RPM Design Goals 

To understand how to use RPM, it can be helpful to understand RPM's design goals: 



Upgradability 

Using RPM, you can upgrade individual components of your system without completely 
reinstalling. When you get a new release of an operating system based on RPM (such as 
Red Hat Enterprise Linux), you do not need to reinstall on your machine (as you do with 
operating systems based on other packaging systems). RPM allows intelligent, 
fully-automated, in-place upgrades of your system. Configuration files in packages are 
preserved across upgrades, so you do not lose your customizations. There are no special 
upgrade files needed to upgrade a package because the same RPM file is used to install 
and upgrade the package on your system. 

Powerful Querying 

RPM is designed to provide powerful querying options. You can do searches through your 
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entire database for packages or just for certain files. You can also easily find out what 
package a file belongs to and from where the package came. The files an RPM package 
contains are in a compressed archive, with a custom binary header containing useful 
information about the package and its contents, allowing you to query individual packages 
quickly and easily. 

System Verification 

Another powerful feature is the ability to verify packages. If you are worried that you deleted 
an important file for some package, verify the package. You are notified of any anomalies. 
At that point, you can reinstall the package if necessary. Any configuration files that you 
modified are preserved during reinstallation. 

Pristine Sources 

A crucial design goal was to allow the use of "pristine" software sources, as distributed by 
the original authors of the software. With RPM, you have the pristine sources along with any 
patches that were used, plus complete build instructions. This is an important advantage for 
several reasons. For instance, if a new version of a program comes out, you do not 
necessarily have to start from scratch to get it to compile. You can look at the patch to see 
what you might need to do. All the compiled-in defaults, and all of the changes that were 
made to get the software to build properly, are easily visible using this technique. 

The goal of keeping sources pristine may only seem important for developers, but it results 
in higher quality software for end users, too. 

2. Using RPM 

RPM has five basic modes of operation (not counting package building): installing, uninstalling, 
upgrading, querying, and verifying. This section contains an overview of each mode. For 
complete details and options, try rpm - help or refer to Section 5, "Additional Resources" tor 
more information on RPM. 

2.1. Finding RPM Packages 

Before using an RPM, you must know where to find them. An Internet search returns many 
RPM repositories, but if you are looking for RPM packages built by Red Hat, they can be found 
at the following locations: 



• The Red Hat Enterprise Linux CD-ROMs 

• The Red Hat Errata Page available at http://www.redhat.com/apps/support/errata/ 

• A Red Hat FTP Mirror Site available at http://www.redhat.com/download/mirror.html 

• Red Hat Network — Refer to Chapter 16, Red Hat Network for more details on Red Hat 
Network 

2.2. Installing 
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RPM packages typically have file names like f oo-i . o-i . i386 . rpm. The file name includes the 
package name (f oo), version (1 . o), release (1), and architecture (i386). To install a package, 
log in as root and type the following command at a shell prompt: 

rpm -Uvh foo-1 . 0-1 . i38 6 .rpm 



If installation is successful, the following output is displayed: 



Preparing . . . 


########################################### 


[100%] 




1 : foo 


########################################### 


[100%] 





As you can see, RPM prints out the name of the package and then prints a succession of hash 
marks as the package is installed as a progress meter. 

The signature of a package is checked automatically when installing or upgrading a package. 
The signature confirms that the package was signed by an authorized party. For example, if the 
verification of the signature fails, an error message such as the following is displayed: 

error: V3 DSA signature: BAD, key ID 0352860f 



If it is a new, header-only, signature, an error message such as the following is displayed: 

error: Header V3 DSA signature: BAD, key ID 0352860f 



If you do not have the appropriate key installed to verify the signature, the message contains 
the word nokey such as: 



warning: V3 DSA signature: NOKEY, key ID 0352860f 



Refer to Section 3, "Checking a Package's Signature" \ox more information on checking a 
package's signature. 



A 



Warning 

If you are installing a kernel package, you should use rpm -ivh instead. Refer to 
Chapter 36, Manually Upgrading the Kernel for details. 



Installing packages is designed to be simple, but you may sometimes see errors. 
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2.2.1. Package Already Installed 



If the package of the same version is already installed, the following is displayed: 



Preparing . . . 


########################################### 


[100%] 




package foo-1.0-1 


is already installed 



If the same version you are trying to install is already installed, and you want to install the 
package anyway, you can use the — repiacepkgs option, which tells RPM to ignore the error: 

rpm -ivh — repiacepkgs foo-1 . 0-1 . i386 .rpm 

This option is helpful if files installed from the RPM were deleted or if you want the original 
configuration files from the RPM to be installed. 

2.2.2. Conflicting Files 



If you attempt to install a package that contains a file which has already been installed by 
another package or an earlier version of the same package, the following is displayed: 



Preparing . . . 


########################################### 


[100%] 




file /usr/bin/foo 


from install of foo-1.0-1 conflicts with file from package 


bar-2.0.20 





To make RPM ignore this error, use the — repiacef lies option: 

rpm -ivh — repiacef iles foo-1 . 0-1 . i386 . rpm 

2.2.3. Unresolved Dependency 

RPM packages can, essentially, depend on other packages, which means that they require 
other packages to be installed to run properly. If you try to install a package which has an 
unresolved dependency, output similar to the following is displayed: 

error: Failed dependencies: 

bar. so. 2 is needed by foo-1.0-1 
Suggested resolutions: 

bar-2.0.2 0-3.i38 6.rpm 

If you are installing a package from the Red Hat Enterprise Linux CD-ROM set, it usually 
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suggest the package(s) needed to resolve the dependency. Find the suggested package(s) on 
the Red Hat Enterprise Linux CD-ROMs or from the Red Hat FTP site (or mirror), and add it to 
the command: 

rpm -ivh foo-1 . 0-1 . i386 .rpm bar-2 . . 20-3 . i386 . rpra 



If installation of both packages is successful, output similar to the following is displayed: 



Preparing . . . 


########################################### 


[100%] 




1 : foo 


########################################### [ 


50%] 




2 : bar 


########################################### 


[100%] 





If it does not suggest a package to resolve the dependency, you can try the --redhatprovides 
option to determine which package contains the required file. You need the rpmdb-redhat 
package installed to use this option. 

rpm -q — redhatprovides bar. so. 2 



If the package that contains bar . so . 2 is in the installed database from the rpmdb-redhat 
package, the name of the package is displayed: 

bar-2. 0.2 0-3. i3 8 6. rpm 



To force the installation anyway (which is not recommended since the package may not run 
correctly), use the — nodeps option. 

2.3. Uninstalling 

Uninstalling a package is just as simple as installing one. Type the following command at a shell 
prompt: 

rpm -e foo 




Note 



Notice that we used the package nametoo, not the name of the original package 
ff/efoo-i . o-i . i386 . rpm. To uninstall a package, replace foo with the actual 
package name of the original package. 
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You can encounter a dependency error when uninstalling a package if another installed 
package depends on the one you are trying to remove. For example: 

error: Failed dependencies: 

foo is needed by (installed) bar-2 . . 20-3 . i386 . rpm 



To cause RPM to ignore this error and uninstall the package anyway, which may break the 
package depending on it, use the — nodeps option. 

2.4. Upgrading 

Upgrading a package is similar to installing one. Type the following command at a shell prompt: 

rpm -Uvh f oo-2 . 0-1 . i386 . rpm 

As part of upgrading a package, RPM automatically uninstalls any old versions of the foo 
package. In fact, you may want to always use -u to install packages which works even when 
there are no previous versions of the package installed. 



Tip 

You don't want to use the -u option for installing kernel packages because RPM 
replaces the previous kernel package. This does not affect a running system, but 
if the new kernel is unable to boot during your next restart, there would be no 
other kernel to boot instead. 

Using the -i option adds the kernel to your GRUB boot menu 

(/etc/grub. conf). Similarly, removing an old, unneeded kernel removes the 

kernel from GRUB. 



Because RPM performs intelligent upgrading of packages with configuration files, you may see 
a message like the following: 

saving /etc/f oo . conf as /etc/ foo . conf . rpmsave 

This message means that your changes to the configuration file may not be forward compatible 
with the new configuration file in the package, so RPM saved your original file and installed a 
new one. You should investigate the differences between the two configuration files and resolve 
them as soon as possible, to ensure that your system continues to function properly. 

Upgrading is really a combination of uninstalling and installing, so during an RPM upgrade you 
can encounter uninstalling and installing errors, plus one more. If RPM thinks you are trying to 
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upgrade to a package with an o/cterversion number, the output is similar to the following: 

package foo-2.0-1 (which is newer than foo-1.0-1) is already installed 

To force RPM to upgrade anyway, use the — oldpackage option: 

rpm -Uvh — oldpackage f oo-l . 0-1 . i386 . rpm 

2.5. Freshening 

Freshening a package is similar to upgrading one. Type the following command at a shell 
prompt: 



rpm -Fvh f oo-l . 2-1 . i386 .rpm 

RPM's freshen option checks the versions of the packages specified on the command line 
against the versions of packages that have already been installed on your system. When a 
newer version of an already-installed package is processed by RPM's freshen option, it is 
upgraded to the newer version. However, RPM's freshen option does not install a package if no 
previously-installed package of the same name exists. This differs from RPM's upgrade option, 
as an upgrade does install packages, whether or not an older version of the package was 
already installed. 

RPM's freshen option works for single packages or package groups. If you have just 
downloaded a large number of different packages, and you only want to upgrade those 
packages that are already installed on your system, freshening does the job. If you use 
freshening, you do not have to delete any unwanted packages from the group that you 
downloaded before using RPM. 

In this case, issue the following command: 

rpm -Fvh * . rpm 

RPM automatically upgrades only those packages that are already installed. 

2.6. Querying 

Use the rpm -q command to query the database of installed packages. The rpm -q foo 
command displays the package name, version, and release number of the installed package 

foo: 

foo-2 . 0-1 
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Note 



To query a package, replace f oo with the actual package name. 



Instead of specifying the package name, use the following options with -q to specify the 
package(s) you want to query. These are called Package Selection Options. 



• -a queries all currently installed packages. 

• -f <fiie> queries the package which owns <fiie>. When specifying a file, you must specify 
the full path of the file (for example, /bin/is). 

• -p <packagefile> queries the package <packagefile>. 

There are a number of ways to specify what information to display about queried packages. The 
following options are used to select the type of information for which you are searching. These 
are called Information Query Options. 



• -i displays package information including name, description, release, size, build date, install 
date, vendor, and other miscellaneous information. 

• -l displays the list of files that the package contains. 

• -s displays the state of all the files in the package. 

• -d displays a list of files marked as documentation (man pages, info pages, READMEs, etc.). 

• -c displays a list of files marked as configuration files. These are the files you change after 
installation to adapt the package to your system (for example, sendmaii . cf , passwd, 

inittab, etc.). 

For the options that display lists of files, add -v to the command to display the lists in a familiar 
is -l format. 

2.7. Verifying 

Verifying a package compares information about files installed from a package with the same 
information from the original package. Among other things, verifying compares the size, MD5 
sum, permissions, type, owner, and group of each file. 

The command rpm -v verifies a package. You can use any of the Package Verify Options listed 
for querying to specify the packages you wish to verify. A simple use of verifying is rpm -v f oo, 
which verifies that all the files in the f oo package are as they were when they were originally 
installed. For example: 
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• To verify a package containing a particular file: 

rpm -Vf /usr/bin/vim 

• To verify ALL installed packages: 

rpm -Va 

• To verify an installed package against an RPM package file: 

rpm -Vp f oo-l . 0-1 . i386 . rpm 

This command can be useful if you suspect that your RPM databases are corrupt. 

If everything verified properly, there is no output. If there are any discrepancies, they are 
displayed. The format of the output is a string of eight characters (a c denotes a configuration 
file) and then the file name. Each of the eight characters denotes the result of a comparison of 
one attribute of the file to the value of that attribute recorded in the RPM database. A single 
period (.) means the test passed. The following characters denote failure of certain tests: 



• 5 


— MD5 checksum 


• S 


— file size 


• L 


— symbolic link 


• T 


— file modification time 


• D 


— device 


• U 


— user 


• G 


— group 


• M 


— mode (includes permissions and file type) 


• ? 


— unreadable file 



If you see any output, use your best judgment to determine if you should remove or reinstall the 
package, or fix the problem in another way. 

3. Checking a Package's Signature 

If you wish to verify that a package has not been corrupted or tampered with, examine only the 
md5sum by typing the following command at a shell prompt (<rpm-fiie> with file name of the 
RPM package): 
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rpm -K — nosignature <rpm-file> 

The message <rpm-fiie>: md5 ok is displayed. This brief message means that the file was 
not corrupted by the download. To see a more verbose message, replace -k with -kw in the 
command. 

On the other hand, how trustworthy is the developer who created the package? If the package 
is signed with the developer's GnuPG key, you know that the developer really is who they say 
they are. 

An RPM package can be signed using Gnu Privacy Guard (or GnuPG), to help you make 
certain your downloaded package is trustworthy. 

GnuPG is a tool for secure communication; it is a complete and free replacement for the 
encryption technology of PGP, an electronic privacy program. With GnuPG, you can 
authenticate the validity of documents and encrypt/decrypt data to and from other recipients. 
GnuPG is capable of decrypting and verifying PGP 5.x files as well. 

During installation, GnuPG is installed by default. That way you can immediately start using 
GnuPG to verify any packages that you receive from Red Hat. First, you must import Red Hat's 
public key. 

3.1. Importing Keys 

To verify Red Hat packages, you must import the Red Hat GPG key. To do so, execute the 
following command at a shell prompt: 

rpm — import /usr/share/rhn/RPM-GPG-KEY 

To display a list of all keys installed for RPM verification, execute the command: 

rpm -qa gpg-pubkey* 

For the Red Hat key, the output includes: 

gpg-pubkey-db42a60e-37ea54 38 

To display details about a specific key, use rpm -q i followed by the output from the previous 
command: 

rpm -qi gpg-pubkey-db42a60e-37ea5438 

3.2. Verifying Signature of Packages 
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To check the GnuPG signature of an RPM file after importing the builder's GnuPG key, use the 
following command (replace <rpm-fiie> with filename of the RPM package): 

rpm -K <rpm-file> 

If all goes well, the following message is displayed: md5 gpg ok. That means that the signature 
of the package has been verified and that it is not corrupt. 

4. Impressing Your Friends with RPM 

RPM is a useful tool for both managing your system and diagnosing and fixing problems. The 
best way to make sense of all of its options is to look at some examples. 



• Perhaps you have deleted some files by accident, but you are not sure what you deleted. To 
verify your entire system and see what might be missing, you could try the following 
command: 

rpm -Va 

If some files are missing or appear to have been corrupted, you should probably either 
re-install the package or uninstall and then re-install the package. 

• At some point, you might see a file that you do not recognize. To find out which package 
owns it, enter: 

rpm -qf /usr/bin/ggv 

The output would look like the following: 

ggv-2 . 6 . 0-2 

• We can combine the above two examples in the following scenario. Say you are having 
problems with /usr/bin/paste. You would like to verify the package that owns that program, 
but you do not know which package owns paste. Enter the following command, 

rpm -Vf /usr/bin/paste 

and the appropriate package is verified. 

• Do you want to find out more information about a particular program? You can try the 
following command to locate the documentation which came with the package that owns that 
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program: 

rpm -qdf /usr/bin/f ree 



The output would be similar to the following: 



/usr/share/doc/procps-3.2. 3 /BUGS 
/usr/share/doc/procps-3.2. 3 /FAQ 
/usr/share/doc/procps-3.2. 3 /NEWS 
/usr/share/doc/procps-3.2. 3/T0D0 
/ us r/ share /man/manl/f ree . 1 . gz 
/ usr / share /man /man 1 /pgr ep . 1 . gz 
/usr/share/man/manl/pkill . 1 . gz 
/usr /share /man /man 1/pmap . 1 . gz 
/usr/ share /man/manl/ps . 1 . gz 
/ usr /share /man / ma.nl/ skill. l.gz 
/usr / share /man /man 1/ slabtop .l.gz 
/usr/ share /man/manl/snice . 1 . gz 
/ usr/ share /man/manl/t load. 1 . gz 
/usr / share /man /manl/ top .l.gz 
/usr/share/man/manl/uptime . 1 . gz 
/usr /share /man /manl / w . 1 . gz 
/usr / share /man /manl / watch .l.gz 
/ usr /share /man /man 5/ sysctl.conf.5.gz 
/usr/ share /man /man 8/ sysctl.8.gz 
/usr/ share/man/man8/vmstat . 8 . gz 

• You may find a new RPM, but you do not know what it does. To find information about it, use 
the following command: 

rpm -qip crontabs-1 . 1 0-7 . noarch . rpm 



The output would be similar to the following: 



Name 


crontabs Relocations: 


(not relocatable) 


Version 


1.10 Vendor: 


Red Hat, Inc. 


Release 


7 Build Date: 


Mon 2 Sep 2004 


05 : 58 : 10 PM EDT 




Install Date 


(not installed) Build Host: 




tweety . build 


redhat . com 




Group 


System Environment/Base Source RPM: 




crontabs-1 . 10-7 . src . rpm 




Size 


1004 License: 


Public Domain 


Signature 


DSA/SHA1, Wed 05 Jan 2005 06:05:25 PM EST 


Key ID 


219180cddb42a60e 




Packager 


Red Hat, Inc. <http://bugzilla.redhat.com/bugzilla> 


Summary 


Root crontab files used to schedule the execution of programs. 


Description 






The crontabs 


package contains root crontab files. Crontab is the 
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program used to install, uninstall, or list the tables used to drive the 
cron daemon. The cron daemon checks the crontab files to see when 
particular commands are scheduled to be executed. If commands are 
scheduled, then it executes them. 

• Perhaps you now want to see what files the crontabs RPM installs. You would enter the 
following: 

rpm -qlp crontabs-1 . 1 0-5 . noarch . rpm 

The output is similar to the following: 

/etc/cr on. daily 
/etc/ cron . hourly 
/etc/cr on .monthly 
/etc/cr on. weekly 
/etc/ crontab 
/usr/bin/ run-parts 

These are just a few examples. As you use it, you will find many more uses for RPM. 

5. Additional Resources 

RPM is an extremely complex utility with many options and methods for querying, installing, 
upgrading, and removing packages. Refer to the following resources to learn more about RPM. 

5.1. Installed Documentation 

• rpm — help — This command displays a quick reference of RPM parameters. 

• man rpm — The RPM man page gives more detail about RPM parameters than the rpm 
— help command. 

5.2. Useful Websites 

• http://www.rpm.org/ — The RPM website. 

• http://www.redhat.com/mailman/listinfo/rpm-list/ — The RPM mailing list is archived here. To 

Subscribe, Send mail tO <rpm-list-request@redhat . com> With the Word subscribe in the 

subject line. 

5.3. Related Books 
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• Red Hat RPM Guide by Eric Foster-Johnson; Wiley, John &Sons, Incorporated — This book 
is a comprehensive guide to RPM, from installing package to building RPMs. 
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Red Hat Network 



Red Hat Network is an Internet solution for managing one or more Red Hat Enterprise Linux 
systems. All Security Alerts, Bug Fix Alerts, and Enhancement Alerts (collectively known as 
Errata Alerts) can be downloaded directly from Red Hat using the Package Updater standalone 
application or through the RHN website available at https://rhn.redhat.com/. 



File Edit View Go Bookmarks Tools Help 



] Red Hat Network Your RHN 



RED HAT NETWORK 



Your RHN Systems Errata Channels Schedule Users Help 




Buy Mow 
Purchase History 



| Systems H| 

% Your RHN ® 



r 




Errata Legend 




Q Security 








# Enhancemen 










System Summary 



Total systems: 
Out of date systems: 
Ungmuped systems: 
Inactive systems: 



| Search | 



Action Summary 



No 5Y5TEWS SELECTED Manage Clear 



10 of 219 relevant errata shown. 



No recent actions. 



r 

Relevant Errata < ) 


Affected Systems 




Updated Xpdf package fixes security issue 


2 


© 


Updated less package fixes security issue 


2 


© 


Updated krb5 packages fix security vulnerabilities 


2 


© 


Updated kernel packages fix security vulnerabilities 


2 


© 


Updated ruby package fixes denial of service issue 


2 




Updated libtiff packages fix security issues 


2 


© 


Updated mozilla packages fix a buffer overflow 


2 


© 


Updated CUPS packages fix security issues 


2 


© 


Updated Xpdf packages fix security issues 


2 




Updated VIM packages fix security vulnerability 


2 



View All Relevant Errata 



Figure 16.1. Your RHN 



Red Hat Network saves you time because you receive email when updated packages are 
released. You do not have to search the Web for updated packages or security alerts. By 
default, Red Hat Network installs the packages as well. You do not have to learn how to use 
RPM or worry about resolving software package dependencies; RHN does it all. 

Red Hat Network features include: 



• Errata Alerts — learn when Security Alerts, Bug Fix Alerts, and Enhancement Alerts are 
issued for all the systems in your network 
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File Edit View Go Bookmarks Tools Help 



GO 



| S Rcd Hat Network - Errata - Relevant 



■ RED HAT NETWORK 
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CD 
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I - 20 of 219 l< < > >l 



Type 


Advisory 
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Updated 


a 
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Updated Xpdf package fixes security issue 


2 


2005-01-26 


a 


RHSA-2005: 068 


Updated less package fixes security issue 


2 


2005-01-26 


a 


RHSA-2005:012 


Updated krb5 packages fix security vulnerabilities 


2 


2005-01-19 
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Updated kernel packages fix security vulnerabilities 
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Updated CUPS packages fix security issues 


2 


2005-01-12 


a 
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Updated samba packages 
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Updated aspell packages 
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Updated BIND packages 
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Figure 16.2. Relevant Errata 



• Automatic email notifications — Receive an email notification when an Errata Alert is issued 
for your system(s) 

• Scheduled Errata Updates — Schedule delivery of Errata Updates 

• Package installation — Schedule package installation on one or more systems with the click 
of a button 

• Package Updater — Use the Package Updater to download the latest software packages 
for your system (with optional package installation) 

• Red Hat Network website — Manage multiple systems, downloaded individual packages, and 
schedule actions such as Errata Updates through a secure Web browser connection from any 
computer 



Caution 

^W^^ You must activate your Red Hat Enterprise Linux product before registering your 
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system with Red Hat Network to make sure your system is entitled to the correct 
services. To activate your product, go to: 



http : //www . redhat . com/ 'apps/ 'activate/ 



After activating your product, register it with Red Hat Network to receive Errata Updates. The 
registration process gathers information about the system that is required to notify you of 
updates. For example, a list of packages installed on the system is compiled so you are only 
notified about updates that are relevant to your system. 

The first time the system is booted, the Software Update Setup Assistant prompts you to 
register. If you did not register then, select Applications (the main menu on the panel) => 
System Tools => Package Updater on your desktop to start the registration process. 
Alternately, execute the command yum update from a shell prompt. 



Step 3: Register a System Profile - Packages 



RPM information is important to determine what updated software packages are relevant 
to this system. 

Include RPM packages installed on this system in my System Profile 
Below is a list of packages present on your system that RPM knows about: 





Package Name 


Version 


Release 




4Suite 


0.11.1 


14 




GConf 


1.0.9 


12 




GConf2 


2.2.1 


1 




Glide3 


2001052 


25 




MAKEDEV 


3.3.6 


1 







ORBit 


0.5.17 


10.4 




ORBit2 


2.6.2 


1 





By default, all packages that RPM knows about will be included in your System Profile. 
Uncheck any packages which you do not want to be included. 



% Cancel 



Back 



£> Forward 



Figure 16.3. Registering with RHN 



After registering, use one of the following methods to start receiving updates: 
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• Select Applications (the main menu on the panel) => System Tools => Package Updater 

on your desktop 

• Execute the command yum from a shell prompt 

• Use the RHN website at https://rhn.redhat.com/ 

• Click on the package icon when it appears in the panel to launch the Package Updater. 
For more detailed instructions, refer to the documentation available at: 

http: / / www . redhat . com/docs /manual s/RHNetwork/ 



Tip 

Red Hat Enterprise Linux includes a convenient panel icon that displays visible 
alerts when there is an update for your Red Hat Enterprise Linux system. This 
panel icon is not present if no updates are available. 
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Part IV. Network-Related 
Configuration 

After explaining how to configure the network, this part discusses topics related to networking 
such as how to allow remote logins, share files and directories over the network, and set up a 
Web server. 



Chapter 17. 



Network Configuration 

To communicate with each other, computers must have a network connection. This is 
accomplished by having the operating system recognize an interface card (such as Ethernet, 
ISDN modem, or token ring) and configuring the interface to connect to the network. 

The Network Administration Tool can be used to configure the following types of network 
interfaces: 

• Ethernet 

• ISDN 

• modem 

• xDSL 

• token ring 

• CIPE 

• wireless devices 

It can also be used to configure IPsec connections, manage DNS settings, and manage the 
/etc/hosts file used to store additional hostnames and IP address combinations. 

To use the Network Administration Tool, you must have root privileges. To start the 
application, go to the Applications (the main menu on the panel) => System Settings => 
Network, or type the command system-conf ig-network at a shell prompt (for example, in an 
XTerm or a GNOME terminal). If you type the command, the graphical version is displayed if X 
is running; otherwise, the text-based version is displayed. 

To use the command line version, execute the command system-conf ig-network-cmd 
--help as root to view all of the options. 
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Hie Profile Help 



New Edit 



Copy Delete Activate Deactivate 





Devices 


Hardware 


I P sec 


DNS 


Hosts 




You may configure network devices associated with 
physical hardware here. Multiple logical devices can be 
associated with a single piece of hardware. 



Profile 


Status 


Device 


Nickname 


Type 




Inactive 


Z ■ ethl 


ethl 


Ethernet 


W 


Active 


§| ethO 


ethO 


Ethernet 



Figure 17.1. Network Administration Tool 



Use the Red Hat Hardware Compatibility List (http://hardware.redhat.com/hcl/) to 
determine if Red Hat Enterprise Linux supports your hardware device. 



1 . Overview 

To configure a network connection with the Network Administration Tool, perform the 
following steps: 
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1. Add a network device associated with the physical hardware device. 

2. Add the physical hardware device to the hardware list, if it does not already exist. 

3. Configure the hostname and DNS settings. 

4. Configure any hosts that cannot be looked up through DNS. 

This chapter discusses each of these steps for each type of network connection. 

2. Establishing an Ethernet Connection 

To establish an Ethernet connection, you need a network interface card (NIC), a network cable 
(usually a CAT5 cable), and a network to connect to. Different networks are configured to use 
different network speeds; make sure your NIC is compatible with the network to which you want 
to connect. 

To add an Ethernet connection, follow these steps: 



1 . Click the Devices tab. 

2. Click the New button on the toolbar. 

3. Select Ethernet connection from the Device Type list, and click Forward. 

4. If you have already added the network interface card to the hardware list, select it from the 
Ethernet card list. Otherwise, select Other Ethernet Card to add the hardware device. 




Note 



The installation program detects supported Ethernet devices and prompts you to 
configure them. If you configured any Ethernet devices during the installation, 
they are displayed in the hardware list on the Hardware tab. 



5. If you selected Other Ethernet Card, the Select Ethernet Adapter window appears. Select 
the manufacturer and model of the Ethernet card. Select the device name. If this is the 
system's first Ethernet card, select ethO as the device name; if this is the second Ethernet 
card, select eth1 (and so on). The Network Administration Tool also allows you to 
configure the resources for the NIC. Click Forward to continue. 

6. In the Configure Network Settings window shown in Figure 17.2, "Ethernet Settings", 
choose between DHCP and a static IP address. If the device receives a different IP address 
each time the network is started, do not specify a hostname. Click Forward to continue. 

7. Click Apply on the Create Ethernet Device page. 
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Configure Network Settings 
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Figure 17.2. Ethernet Settings 



After configuring the Ethernet device, it appears in the device list as shown in Figure 17.3, 
"Ethernet Device". 
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Figure 17.3. Ethernet Device 



Be sure to select File => Save to save the changes. 

After adding the Ethernet device, you can edit its configuration by selecting the device from the 
device list and clicking Edit. For example, when the device is added, it is configured to start at 
boot time by default. To change this setting, select to edit the device, modify the Activate 
device when computer starts value, and save the changes. 

When the device is added, it is not activated immediately, as seen by its Inactive status. To 
activate the device, select it from the device list, and click the Activate button. If the system is 
configured to activate the device when the computer starts (the default), this step does not have 
to be performed again. 

If you associate more than one device with an Ethernet card, the subsequent devices are 
device aliases. A device alias allows you to setup multiple virtual devices for one physical 
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device, thus giving the one physical device more than one IP address. For example, you can 
configure an eth1 device and an eth1:1 device. For details, refer to Section 11, "Device Aliases". 

3. Establishing an ISDN Connection 

An ISDN connection is an Internet connection established with a ISDN modem card through a 
special phone line installed by the phone company. ISDN connections are popular in Europe. 

To add an ISDN connection, follow these steps: 



1 . Click the Devices tab. 

2. Click the New button on the toolbar. 

3. Select ISDN connection from the Device Type list, and click Forward. 

4. Select the ISDN adapter from the pulldown menu. Then configure the resources and D 
channel protocol for the adapter. Click Forward to continue. 



Select ISDN Adapter 



ISDN Adapters: 
Resource 



ACER P10 



IRQ: 

MEM: 

10: 

lOl: 

102: 



0x300 



D Channel Protocol 

® Euro ISDN (EDSS1) 

O 1TRE 



U Cancel 



< Back 



[> Forward 



Figure 17.4. ISDN Settings 



5. If your Internet Service Provider (ISP) is in the pre-configured list, select it. Otherwise, enter 
the required information about your ISP account. If you do not know the values, contact your 
ISP. Click Forward. 

6. In the IP Settings window, select the Encapsulation Mode and whether to obtain an IP 
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address automatically or to set a static IP instead. Click Forward when finished. 
7. On the Create Dialup Connection page, click Apply. 

After configuring the ISDN device, it appears in the device list as a device with type ISDN as 
shown in Figure 17.5, "ISDN Device". 

Be sure to select File => Save to save the changes. 

After adding the ISDN device, you can edit its configuration by selecting the device from the 
device list and clicking Edit. For example, when the device is added, it is configured not to start 
at boot time by default. Edit its configuration to modify this setting. Compression, PPP options, 
login name, password, and more can be changed. 

When the device is added, it is not activated immediately, as seen by its Inactive status. To 
activate the device, select it from the device list, and click the Activate button. If the system is 
configured to activate the device when the computer starts (the default), this step does not have 
to be performed again. 
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Figure 17.5. ISDN Device 

4. Establishing a Modem Connection 

A modem can be used to configure an Internet connection over an active phone line. An 
Internet Service Provider (ISP) account (also called a dial-up account) is required. 

To add a modem connection, follow these steps: 



1 . Click the Devices tab. 

2. Click the New button on the toolbar. 

3. Select Modem connection from the Device Type list, and click Forward. 

4. If there is a modem already configured in the hardware list (on the Hardware tab), the 
Network Administration Tool assumes you want to use it to establish a modem connection. 
If there are no modems already configured, it tries to detect any modems in the system. This 
probe might take a while. If a modem is not found, a message is displayed to warn you that 
the settings shown are not values found from the probe. 

5. After probing, the window in Figure 17.6, "Modem Settings" appears. 
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Figure 17.6. Modem Settings 
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6. Configure the modem device, baud rate, flow control, and modem volume. If you do not know 
these values, accept the defaults if the modem was probed successfully. If you do not have 
touch tone dialing, uncheckthe corresponding checkbox. Click Forward. 

7. If your ISP is in the pre-configured list, select it. Otherwise, enter the required information 
about your ISP account. If you do not know these values, contact your ISP. Click Forward. 

8. On the IP Settings page, select whether to obtain an IP address automatically or whether to 
set one statically. Click Forward when finished. 

9. On the Create Dialup Connection page, click Apply. 

After configuring the modem device, it appears in the device list with the type Modem as shown in 
Figure 17.7, "Modem Device". 
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Figure 17.7. Modem Device 
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Be sure to select File => Save to save the changes. 

After adding the modem device, you can edit its configuration by selecting the device from the 
device list and clicking Edit. For example, when the device is added, it is configured not to start 
at boot time by default. Edit its configuration to modify this setting. Compression, PPP options, 
login name, password, and more can also be changed. 

When the device is added, it is not activated immediately, as seen by its Inactive status. To 
activate the device, select it from the device list, and click the Activate button. If the system is 
configured to activate the device when the computer starts (the default), this step does not have 
to be performed again. 

5. Establishing an xDSL Connection 

DSL stands for Digital Subscriber Lines. There are different types of DSL such as ADSL, IDSL, 
and SDSL. The Network Administration Tool uses the term xDSL to mean all types of DSL 
connections. 

Some DSL providers require that the system is configured to obtain an IP address through 
DHCP with an Ethernet card. Some DSL providers require you to configure a PPPoE 
(Point-to-Point Protocol over Ethernet) connection with an Ethernet card. Ask your DSL provider 
which method to use. 

If you are required to use DHCP, refer to Section 2, "Establishing an Ethernet Connection"\o 
configure your Ethernet card. 

If you are required to use PPPoE, follow these steps: 



1 . Click the Devices tab. 

2. Click the New button. 

3. Select xDSL connection from the Device Type list, and click Forward. 

4. If your Ethernet card is in the hardware list, select the Ethernet Device from the pulldown 
menu from the page shown in Figure 17.8, "xDSL Settings". Otherwise, the Select Ethernet 
Adapter window appears. 




Note 



The installation program detects supported Ethernet devices and prompts you to 
configure them. If you configured any Ethernet devices during the installation, 
they are displayed in the hardware list on the Hardware tab. 
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Configure DSL connection 




Select the ethernet device for this account. 
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S3 Cancel 
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Figure 17.8. xDSL Settings 



5. If the Select Ethernet Adapter window appears, select the manufacturer and model of the 
Ethernet card. Select the device name. If this is the system's first Ethernet card, select ethO 
as the device name; if this is the second Ethernet card, select eth1 (and so on). The 
Network Administration Tool also allows you to configure the resources for the NIC. Click 
Forward to continue. 

6. Enter the Provider Name, Login Name, and Password. If you have a T-Online account, 
instead of entering a Login Name and Password in the default window, click the T-Online 
Account Setup button and enter the required information. Click Forward to continue. 

7. On the Create DSL Connection page, click Apply. 

After configuring the DSL connection, it appears in the device list as shown in Figure 17.7, 
"Modem Device". 



171 



Chapter 17. Network Configuration 



Hie Profile Help 



New Edit 



Copy Del ere Activate Deactivate 





Devices 


Hardware 


I P sec 


DNS 


Hosts 




You may configure network devices associated with 
physical hardware here. Multiple logical devices can be 
associated with a single piece of hardware. 



Profile 


Status 


Device 


Nickname 


Type 


IB 


ft Inactive 


■#■ pppO 


Provider 


xDSL 



Figure 17.9. xDSL Device 



Be sure to select File => Save to save the changes. 

After adding the xDSL connection, you can edit its configuration by selecting the device from the 
device list and clicking Edit. For example, when the device is added, it is configured not to start 
at boot time by default. Edit its configuration to modify this setting. 

When the device is added, it is not activated immediately, as seen by its Inactive status. To 
activate the device, select it from the device list, and click the Activate button. If the system is 
configured to activate the device when the computer starts (the default), this step does not have 
to be performed again. 

6. Establishing a Token Ring Connection 

A token ring networkls a network in which all the computers are connected in a circular pattern. 
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A token, or a special network packet, travels around the token ring and allows computers to 
send information to each other. 



Tip 

For more information on using token rings under Linux, refer to the Linux Token 
Ring Project website available at http://www.linuxtr.net/. 



To add a token ring connection, follow these steps: 




1 . Click the Devices tab. 

2. Click the New button on the toolbar. 

3. Select Token Ring connection from the Device Type list and click Forward. 

4. If you have already added the token ring card to the hardware list, select it from the 
Tokenring card list. Otherwise, select Other Tokenring Card to add the hardware device. 

5. If you selected Other Tokenring Card, the Select Token Ring Adapter window as shown in 
Figure 17.10, "Token Ring Settings" appears. Select the manufacturer and model of the 
adapter. Select the device name. If this is the system's first token ring card, select trO; if this 
is the second token ring card, select tr1 (and so on). The Network Administration Tool also 
allows the user to configure the resources for the adapter. Click Forward to continue. 
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Figure 17.10. Token Ring Settings 



6. On the Configure Network Settings page, choose between DHCP and static IP address. 
You may specify a hostname for the device. If the device receives a dynamic IP address 
each time the network is started, do not specify a hostname. Click Forward to continue. 

7. Click Apply on the Create Tokenring Device page. 

After configuring the token ring device, it appears in the device list as shown in Figure 17.11, 
"Token Ring Device". 
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Figure 17.11. Token Ring Device 



Be sure to select File => Save to save the changes. 

After adding the device, you can edit its configuration by selecting the device from the device list 
and clicking Edit. For example, you can configure whether the device is started at boot time. 

When the device is added, it is not activated immediately, as seen by its Inactive status. To 
activate the device, select it from the device list, and click the Activate button. If the system is 
configured to activate the device when the computer starts (the default), this step does not have 
to be performed again. 

7. Establishing a Wireless Connection 

Wireless Ethernet devices are becoming increasingly popular. The configuration is similar to the 
Ethernet configuration except that it allows you to configure settings such as the SSID and key 
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for the wireless device. 

To add a wireless Ethernet connection, follow these steps: 



1 . Click the Devices tab. 

2. Click the New button on the toolbar. 

3. Select Wireless connection from the Device Type list and click Forward. 

4. If you have already added the wireless network interface card to the hardware list, select it 
from the Wireless card list. Otherwise, select Other Wireless Card to add the hardware 
device. 




Note 



The installation program usually detects supported wireless Ethernet devices and 
prompts you to configure them. If you configured them during the installation, 
they are displayed in the hardware list on the Hardware tab. 



5. If you selected Other Wireless Card, the Select Ethernet Adapter window appears. Select 
the manufacturer and model of the Ethernet card and the device. If this is the first Ethernet 
card for the system, select ethO; if this is the second Ethernet card for the system, select 
eth1 (and so on). The Network Administration Tool also allows the user to configure the 
resources for the wireless network interface card. Click Forward to continue. 

6. On the Configure Wireless Connection page as shown in Figure 17.12, "Wireless 
Settings", configure the settings for the wireless device. 
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Figure 17.12. Wireless Settings 



7. On the Configure Network Settings page, choose between DHCP and static IP address. 
You may specify a hostname for the device. If the device receives a dynamic IP address 
each time the network is started, do not specify a hostname. Click Forward to continue. 

8. Click Apply on the Create Wireless Device page. 

After configuring the wireless device, it appears in the device list as shown in Figure 17. 13, 
"Wireless Device". 
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Figure 17.13. Wireless Device 



Be sure to select File => Save to save the changes. 

After adding the wireless device, you can edit its configuration by selecting the device from the 
device list and clicking Edit. For example, you can configure the device to activate at boot time. 

When the device is added, it is not activated immediately, as seen by its Inactive status. To 
activate the device, select it from the device list, and click the Activate button. If the system is 
configured to activate the device when the computer starts (the default), this step does not have 
to be performed again. 

8. Managing DNS Settings 

The DNS tab allows you to configure the system's hostname, domain, name servers, and 
search domain. Name servers are used to look up other hosts on the network. 
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If the DNS server names are retrieved from DHCP or PPPoE (or retrieved from the ISP), do not 
add primary, secondary, or tertiary DNS servers. 

If the hostname is retrieved dynamically from DHCP or PPPoE (or retrieved from the ISP), do 
not change it. 
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Figure 17.14. DNS Configuration 




Note 



The name servers section does not configure the system to be a name server. 
Instead, it configures which name servers to use when resolving IP addresses to 
hostnames and vice-versa. 
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A 



Warning 

If the hostname is changed and system-conf ig-network is started on the local 
host, you may not be able to start another X11 application. As such, you may 
have to re-login to a new desktop session. 



9. Managing Hosts 

The Hosts tab allows you to add, edit, or remove hosts from the /etc/hosts file. This file 
contains IP addresses and their corresponding hostnames. 

When your system tries to resolve a hostname to an IP address or tries to determine the 
hostname for an IP address, it refers to the /etc/hosts file before using the name servers (if 
you are using the default Red Hat Enterprise Linux configuration). If the IP address is listed in 
the /etc/hosts file, the name servers are not used. If your network contains computers whose 
IP addresses are not listed in DNS, it is recommended that you add them to the /etc/hosts 
file. 

To add an entry to the /etc/hosts file, go to the Hosts tab, click the New button on the toolbar, 
provide the requested information, and click OK. Select File => Save or press Ctrl-S to save 
the changes to the /etc/hosts file. The network or network services do not need to be 
restarted since the current version of the file is referred to each time an address is resolved. 



A 



Warning 

Do not remove the locaihost entry. Even if the system does not have a network 
connection or have a network connection running constantly, some programs 
need to connect to the system via the locaihost loopback interface. 
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Figure 17.15. Hosts Configuration 



To change lookup order, edit the /etc/host . conf file. The line order hosts, 
bind specifies that /etc/hosts takes precedence over the name servers. 
Changing the line to order bind, hosts configures the system to resolve 
hostnames and IP addresses using the name servers first. If the IP address 
cannot be resolved through the name servers, the system then looks for the IP 
address in the /etc/hosts file. 



10. Working with Profiles 
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Multiple logical network devices can be created for each physical hardware device. For 
example, if you have one Ethernet card in your system (ethO), you can create logical network 
devices with different nicknames and different configuration options, all to be specifically 
associated with ethO. 

Logical network devices are different from device aliases. Logical network devices associated 
with the same physical device must exist in different profiles and cannot be activated 
simultaneously. Device aliases are also associated with the same physical hardware device, but 
device aliases associated with the same physical hardware can be activated at the same time. 
Refer to Section 11, "Device Aliases"for details about creating device aliases. 

Profiles can be used to create multiple configuration sets for different networks. A configuration 
set can include logical devices as well as hosts and DNS settings. After configuring the profiles, 
you can use the Network Administration Tool to switch back and forth between them. 

By default, there is one profile called Common. To create a new profile, select Profile => New 
from the pull-down menu, and enter a unique name for the profile. 

You are now modifying the new profile as indicated by the status bar at the bottom of the main 
window. 

Click on an existing device already in the list and click the Copy button to copy the existing 
device to a logical network device. If you use the New button, a network alias is created, which 
is incorrect. To change the properties of the logical device, select it from the list and click Edit. 
For example, the nickname can be changed to a more descriptive name, such as ethO_of fice, 
so that it can be recognized more easily. 

In the list of devices, there is a column of checkboxes labeled Profile. For each profile, you can 
check or uncheck devices. Only the checked devices are included for the currently selected 
profile. For example, if you create a logical device named ethO_of f ice in a profile called 
office and want to activate the logical device if the profile is selected, uncheck the etho device 
and check the etho_office device. 

For example, Figure 17.16, "Office Profile" shows a profile called Office with the logical device 
ethO_office. It is configured to activate the first Ethernet card using DHCP. 
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Figure 17.16. Office Profile 



Notice that the Home profile as shown in Figure 17.17, "Home Profile" activates the ethO_home 
logical device, which is associated with etho. 
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Figure 17.17. Home Profile 



You can also configure etho to activate in the Office profile only and to activate a PPP 
(modem) device in the Home profile only. Another example is to have the Common profile 
activate etho and an Away profile activate a PPP device for use while traveling. 

To activate a profile at boot time, modify the boot loader configuration file to include the 
netprof iie=<profiiename> option. For example, if the system uses GRUB as the boot loader 

and /boot/grub/grub. conf contains: 

title Red Hat Enterprise Linux (2. 6. 9-5. EL) root (hdO,0) kernel 
/vmlinuz-2 . 6 . 9-5 . EL ro root=/dev/VolGroupOO/LogVolOO rhgb quiet initrd 
/initrd-2 . 6 . 9-5 . EL . img 



Modify it to the following (where <profiiename> is the name of the profile to be activated at 
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boot time): 

title Red Hat Enterprise Linux (2. 6. 9-5. EL) root (hdO,0) kernel 

/ vmlinuz-2 . 6 . 9-5 . EL ro root=/dev/VolGroupOO/LogVolOO \ 

netprof i.le=<profllename> \ rhgb quiet initrd /initrd-2 . 6 . 9-5 . EL . img 



To switch profiles after the system has booted, go to Applications (the main menu on the panel) 
=> System Tools => Network Device Control (or type the command 
system-control-network) to select a profile and activate it. The activate profile section only 
appears in the Network Device Control interface if more than the default Common interface 
exists. 

Alternatively, execute the following command to enable a profile (replace <profiiename> with 
the name of the profile): 

system-conf ig-network-cmd — profile <profilename> — activate 



1 1 . Device Aliases 

Device aliases are virtual devices associated with the same physical hardware, but they can be 
activated at the same time to have different IP addresses. They are commonly represented as 
the device name followed by a colon and a number (for example, eth0:1). They are useful if you 
want to have multiple IP addresses for a system that only has one network card. 

After configuring the Ethernet device — such as etho — to use a static IP address (DHCP does 
not work with aliases), go to the Devices tab and click New. Select the Ethernet card to 
configure with an alias, set the static IP address for the alias, and click Apply to create it. Since 
a device already exists for the Ethernet card, the one just created is the alias, such as etho : 1. 



A 



Warning 

If you are configuring an Ethernet device to have an alias, neither the device nor 
the alias can be configured to use DHCP. You must configure the IP addresses 
manually. 



Figure 17. 18, "Network Device Alias Example" shows an example of one alias for the etho 
device. Notice the etho : 1 device — the first alias for etho. The second alias for etho would 
have the device name etho : 2, and so on. To modify the settings for the device alias, such as 
whether to activate it at boot time and the alias number, select it from the list and click the Edit 
button. 
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Figure 17.18. Network Device Alias Example 



Select the alias and click the Activate button to activate the alias. If you have configured 
multiple profiles, select which profiles in which to include it. 

To verify that the alias has been activated, use the command /sbin/if conf ig. The output 
should show the device and the device alias with different IP addresses: 

ethO Link encap : Ethernet HWaddr 00 : AO : CC : 60 : B7 : G4 inet addr : 1 92 . 1 68 . 1 00 . 5 
Beast : 192 . 168 . 100 . 255 Mask : 255 . 255 . 255 . UP BROADCAST RUNNING MULTICAST 
MTU:1500 Metric:l RX packets : 161930 errors : 1 dropped:0 overruns:0 f rame : TX 
packets : 244570 errors : dropped:0 overruns : carrier:0 collisions : 475 
txqueuelen: 100 RX bytes : 55075551 (52.5 Mb) TX bytes : 178108895 (169.8 Mb) 
Interrupt:10 Base address : 0x9000 ethO : 1 Link encap : Ethernet HWaddr 
00 :A0 :CC: 60 :B7 :G4 inet addr : 1 92 . 1 68 . 1 00 . 42 Beast : 192 . 168 . 100 . 255 
Mask : 255 . 255 . 255 . UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:l 
Interrupt: 10 Base address : 0x9000 lo Link encap: Local Loopback inet 
addr : 127 . . . 1 Mask : 255 . . . UP LOOPBACK RUNNING MTU:16436 Metric:! RX 
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packets: 5998 errors : dropped: overruns : f rame : TX packets: 5998 errors :0 
dropped: overruns : carrier :0 collisions :0 txqueuelen:0 RX bytes : 1627579 
(1.5 Mb) TX bytes : 1627579 (1.5 Mb) 

12. Saving and Restoring the Network Configuration 

The command line version of Network Administration Tool can be used to save the system's 
network configuration to a file. This file can then be used to restore the network settings to a 
Red Hat Enterprise Linux system. 

This feature can be used as part of an automated backup script, to save the configuration 
before upgrading or reinstalling, or to copy the configuration to a different Red Hat Enterprise 
Linux system. 

To save, or export, the network configuration of a system to the file /tmp/ ne t work- con f ig, 
execute the following command as root: 

system-conf ig-network-cmd -e > /tmp/network-conf ig 

To restore, or import, the network configuration from the file created from the previous 
command, execute the following command as root: 

system-conf ig-network-cmd -i -c -f /tmp/network-conf ig 

The -i option means to import the data, the -c option means to clear the existing configuration 
prior to importing, and the -f option specifies that the file to import is as follows. 
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Firewalls 

Information security is commonly thought of as a process and not a product. However, standard 
security implementations usually employ some form of dedicated mechanism to control access 
privileges and restrict network resources to users who are authorized, identifiable, and 
traceable. Red Hat Enterprise Linux includes several tools to assist administrators and security 
engineers with network-level access control issues. 

Firewalls are one of the core components of a network security implementation. Several 
vendors market firewall solutions catering to all levels of the marketplace: from home users 
protecting one PC to data center solutions safeguarding vital enterprise information. Firewalls 
can be stand-alone hardware solutions, such as firewall appliances by Cisco, Nokia, and 
Sonicwall. Vendors such as Checkpoint, McAfee, and Symantec have also developed 
proprietary software firewall solutions for home and business markets. 



Apart from the differences between hardware and software firewalls, there are also differences 
in the way firewalls function that separate one solution from another. Table 18. 1, "Firewall 
Types" details three common types of firewalls and how they function: 



Method 


Description 


Advantages 


Disadvantages 


NAT 


Network Address 
Translation (NAT) places 
private IP subnetworks 
behind one or a small pool 
of public IP addresses, 
masquerading all requests 
to one source rather than 
several. The Linux kernel 
has built-in NAT 
functionality through the 
Netfilter kernel subsystem. 


■ Can be configured 
transparently to machines 
on a LAN 

■ Protection of many 
machines and services 
behind one or more 
external IP addresses 
simplifies administration 
duties 

■ Restriction of user 
access to and from the 
LAN can be configured by 
opening and closing ports 
on the NAT 
firewall/gateway 


■ Cannot prevent malicious 
activity once users 
connect to a service 
outside of the firewall 


Packet 
Filter 


A packet filtering firewall 
reads each data packet 
that passes through a 
LAN. It can read and 
process packets by 
header information and 
filters the packet based on 
sets of programmable 
rules implemented by the 
firewall administrator. The 


■ Customizable through 

the iptabies front-end 
utility 

■ Does not require any 
customization on the client 
side, as all network activity 
is filtered at the router 
level rather than the 
application level 


■ Cannot filter packets for 
content like proxy firewalls 

■ Processes packets at the 
protocol layer, but cannot 
filter packets at an 
application layer 

■ Complex network 
architectures can make 
establishing packet 
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Method 


Description 


Advantages 


Disadvantages 




Linux kernel has built-in 


■ Since packets are not 


filtering rules difficult, 




packet filtering 


transmitted through a 


especially if coupled with 




functionality through the 


proxy, network 


IP masquerading or local 




Netfilter kernel subsystem. 


performance is faster due 


subnets and DMZ 






to direct connection from 


networks 






client to remote host 




Proxy 


Proxy firewalls filter all 








requests of a certain 


■ Gives administrators 


■ Proxies are often 




protocol or type from LAN 


control over what 


application-specific (HTTP, 




clients to a proxy machine, 


applications and protocols 


Telnet, etc.), or 




which then makes those 


function outside of the 


protocol-restricted (most 




requests to the Internet on 


LAN 


proxies work with 




behalf of the local client. A 


■ Some proxy servers can 


TCP-connected services 




proxy machine acts as a 


cache frequently-accessed 


only) 




buffer between malicious 


data locally rather than 


■ Application services 




remote users and the 


having to use the Internet 


cannot run behind a proxy, 




internal network client 


connection to request it. 


so your application servers 




machines. 


This helps to reduce 


must use a separate form 






bandwidth consumption 


of network security 






■ Proxy services can be 


■ Proxies can become a 






logged and monitored 


network bottleneck, as all 






closely, allowing tighter 


requests and 






control over resource 


transmissions are passed 






utilization on the network 


through one source rather 








than directly from a client 








to a remote service 



Table 18.1. Firewall Types 



1. Netfilter and IPTables 

The Linux kernel features a powerful networking subsystem called Netfilter. The Netfilter 
subsystem provides stateful or stateless packet filtering as well as NAT and IP masquerading 
services. Netfilter also has the ability to mangle IP header information for advanced routing and 
connection state management. Netfilter is controlled using the iptabies tool. 

1.1. IPTables Overview 

The power and flexibility of Netfilter is implemented using the iptabies administration tool, a 
command line tool similar in syntax to its predecessor, ipchains. 

A similar syntax does not mean similar implementation, however, ipchains requires intricate 
rule sets for: filtering source paths; filtering destination paths; and filtering both source and 
destination connection ports. 
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By contrast, iptabies uses the Netfilter subsystem to enhance network connection, inspection, 
and processing, iptabies features advanced logging, pre- and post-routing actions, network 
address translation, and port forwarding, all in one command line interface. 

This section provides an overview of iptabies. 

2. Basic Firewall Configuration 

Just as a firewall in a building attempts to prevent a fire from spreading, a computer firewall 
attempts to prevent malicious software from spreading to your computer. It also helps to prevent 
unauthorized users from accessing your computer. 

In a default Red Hat Enterprise Linux installation, a firewall exists between your computer or 
network and any untrusted networks, for example the Internet. It determines which services on 
your computer remote users can access. A properly configured firewall can greatly increase the 
security of your system. It is recommended that you configure a firewall for any Red Hat 
Enterprise Linux system with an Internet connection. 

2.1. Security Level Configuration Tool 

During the Firewall Configuration screen of the Red Hat Enterprise Linux installation, you 
were given the option to enable a basic firewall as well as to allow specific devices, incoming 
services, and ports. 

After installation, you can change this preference by using the Security Level Configuration 
Tool. 

To start this application, use the following command: 

[ root @my Server ~] # system-conf ig-selinux 
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Eu= Please choose the security level for the system, 



[Firewall Options! 



SELinux 



Security level: 



Enable firewall 



Trusted services: 



Trusted devices: 



Other pons: (1029:tcp) 



□ WWW (HTTP) 

□ FTP 

□ SSH 

□ Telnet 

□ Mail (SMTP) 



□ ethO 

□ sitO 



Cancel 



<^ OK 



Figure 18.1. Security Level Configuration Tool 



Note 




The Security Level Configuration Tool only configures a basic firewall. 



2.2. Enabling and Disabling the Firewall 

Select one of the following options for the firewall: 



Disabled — Disabling the firewall provides complete access to your system and does no 
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security checking. This should only be selected if you are running on a trusted network (not 
the Internet) or need to configure a custom firewall using the iptables command line tool. 



A 



Warning 

Firewall configurations and any customized firewall rules are stored in the 
/etc/sysconf ig/iptabies file. If you choose Disabled and click OK, these 
configurations and firewall rules will be lost. 



• Enabled — This option configures the system to reject incoming connections that are not in 
response to outbound requests, such as DNS replies or DHCP requests. If access to services 
running on this machine is needed, you can choose to allow specific services through the 
firewall. 

If you are connecting your system to the Internet, but do not plan to run a server, this is the 
safest choice. 

2.3. Trusted Services 

Enabling options in the Trusted services list allows the specified service to pass through the 
firewall. 



WWW (HTTP) 

The HTTP protocol is used by Apache (and by other Web servers) to serve web pages. If 
you plan on making your Web server publicly available, select this check box. This option is 
not required for viewing pages locally or for developing web pages. This service requires 
that the httpd package be installed. 

Enabling WWW (HTTP) will not open a port for HTTPS, the SSL version of HTTP. If this 
service is required, select the Secure WWW (HTTPS) check box. 

FTP 

The FTP protocol is used to transfer files between machines on a network. If you plan on 
making your FTP server publicly available, select this check box. This service requires that 
the vsftpd package be installed. 

SSH 

Secure Shell (SSH) is a suite of tools for logging into and executing commands on a remote 
machine. To allow remote access to the machine via ssh, select this check box. This 
service requires that the openssh-server package be installed. 

Telnet 

Telnet is a protocol for logging into remote machines. Telnet communications are 
unencrypted and provide no security from network snooping. Allowing incoming Telnet 
access is not recommended. To allow remote access to the machine via telnet, select this 
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check box. This service requires that the telnet-server package be installed. 
Mail (SMTP) 

SMTP is a protocol that allows remote hosts to connect directly to your machine to deliver 
mail. You do not need to enable this service if you collect your mail from your ISP's server 
using POP3 or IMAP, or if you use a tool such as fetchmaii. To allow delivery of mail to 
your machine, select this check box. Note that an improperly configured SMTP server can 
allow remote machines to use your server to send spam. 

NFS4 

The Network File System (NFS) is a file sharing protocol commonly used on *NIX systems. 
Version 4 of this protocol is more secure than its predecessors. If you want to share files or 
directories on your system with other network users, select this check box. 

Samba 

Samba is an implementation of Microsoft's proprietary SMB networking protocol. If you need 
to share files, directories, or locally-connected printers with Microsoft Windows machines, 
select this check box. 

2.4. Other Ports 

The Security Level Configuration Tool includes an Other ports section for specifying custom 
IP ports as being trusted by iptabies. For example, to allow IRC and Internet printing protocol 
(IPP) to pass through the firewall, add the following to the Other ports section: 

194 :tcp, 631 :tcp 

2.5. Saving the Settings 

Click OK to save the changes and enable or disable the firewall. If Enable firewall was 

selected, the options selected are translated to iptabies commands and written to the 
/etc/sysconf ig/iptabies file. The iptabies service is also started so that the firewall is 
activated immediately after saving the selected options. If Disable firewall was selected, the 

/etc/sysconf ig/iptabies file is removed and the iptabies service is stopped immediately. 

The selected options are also written to the /etc/ sysconf ig/system-conf ig-selinux file SO 
that the settings can be restored the next time the application is started. Do not edit this file by 
hand. 

Even though the firewall is activated immediately, the iptabies service is not configured to start 
automatically at boot time. Refer to Section 2.6, "Activating the IPTables Service" tor more 
information. 

2.6. Activating the IPTables Service 

The firewall rules are only active if the iptabies service is running. To manually start the 
service, use the following command: 

[rootSmyServer ~] # service iptabies restart 
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To ensure that iptabies starts when the system is booted, use the following command: 



[root@myServer ~] # chkconfig — level 345 iptabies on 



The ipohains service is not included in Red Hat Enterprise Linux. However, if ipchains is 
installed (for example, an upgrade was performed and the system had ipchains previously 
installed), the ipchains and iptabies services should not be activated simultaneously. To 
make sure the ipchains service is disabled and configured not to start at boot time, use the 
following two commands: 



[root@myServer ~] 


# 


service ipchains stop 


[root@myServer ~] 


# 


chkconfig — level 345 ipchains off 



3. Using IPTables 

The first step in using iptabies is to start the iptabies service. Use the following command to 
start the iptabies service: 

[ root@myServer ~] # service iptabies start 



Note 

The ip6tabies service can be turned off if you intend to use the iptabies 
service only. If you deactivate the ip6tabies service, remember to deactivate 
the IPv6 network also. Never leave a network device active without the matching 
firewall. 



To force iptabies to start by default when the system is booted, use the following command: 

[rootdmyServer ~] # chkconfig — level 345 iptabies on 

This forces iptabies to start whenever the system is booted into runlevel 3, 4, or 5. 

3.1. IPTables Command Syntax 

The following sample iptabies command illustrates the basic command syntax: 
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[ rootSmyServer ~ ] # iptables -A <chain> -j <target> 

The -a option specifies that the rule be appended to <chain>. Each chain is comprised of one or 
more rules, and is therefore also known as a ruleset. 

The three built-in chains are INPUT, OUTPUT, and FORWARD. These chains are permanent 
and cannot be deleted. The chain specifies the point at which a packet is manipulated. 

The - j <target> option specifies the target of the rule; i.e., what to do if the packet matches 
the rule. Examples of built-in targets are ACCEPT, DROP, and REJECT. 

Refer to the iptables man page for more information on the available chains, options, and 
targets. 

3.2. Basic Firewall Policies 

Establishing basic firewall policies creates a foundation for building more detailed, user-defined 
rules. 

Each iptables chain is comprised of a default policy, and zero or more rules which work in 
concert with the default policy to define the overall ruleset for the firewall. 

The default policy for a chain can be either DROP or ACCEPT. Security-minded administrators 
typically implement a default policy of DROP, and only allow specific packets on a case-by-case 
basis. For example, the following policies block all incoming and outgoing packets on a network 
gateway: 



[ root@myServer ~ ' 


I # iptables 


-P INPUT DROP 


[ root@myServer ~ ' 


I # iptables 


-P OUTPUT DROP 



It is also recommended that any forwarded packets — network traffic that is to be routed from 
the firewall to its destination node — be denied as well, to restrict internal clients from 
inadvertent exposure to the Internet. To do this, use the following rule: 

[rootdmyServer ~ ] # iptables -P FORWARD DROP 

When you have established the default policies for each chain, you can create and save further 
rules for your particular network and security requirements. 

The following sections describe how to save iptables rules and outline some of the rules you 
might implement in the course of building your iptables firewall. 

3.3. Saving and Restoring IPTables Rules 
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Changes to iptabies are transitory; if the system is rebooted or if the iptabies service is 
restarted, the rules are automatically flushed and reset. To save the rules so that they are 
loaded when the iptabies service is started, use the following command: 



[rootSmyServer ~ ] # service iptabies save 



The rules are stored in the file /etc/sysconf ig/iptabies and are applied whenever the 
service is started or the machine is rebooted. 

4. Common IPTables Filtering 

Preventing remote attackers from accessing a LAN is one of the most important aspects of 
network security. The integrity of a LAN should be protected from malicious remote users 
through the use of stringent firewall rules. 

However, with a default policy set to block all incoming, outgoing, and forwarded packets, it is 
impossible for the firewall/gateway and internal LAN users to communicate with each other or 
with external resources. 

To allow users to perform network- related functions and to use networking applications, 
administrators must open certain ports for communication. 

For example, to allow access to port 80 on the firewall, append the following rule: 



[root@myServer ~ ] # iptabies -A INPUT -p tcp -m tcp — dport 80 -j ACCEPT 



This allows users to browse websites that communicate using the standard port 80. To allow 
access to secure websites (for example, https://www.example.com/), you also need to provide 
access to port 443, as follows: 



[rootdmyServer ~ ] # iptabies -A INPUT -p tcp -m tcp — dport 443 -j ACCEPT 



* 



Important 

When creating an iptabies ruleset, order is important. 

If a rule specifies that any packets from the 1 92.1 68.100.0/24 subnet be 
dropped, and this is followed by a rule that allows packets from 192.168.100.13 
(which is within the dropped subnet), then the second rule is ignored. 

The rule to allow packets from 1 92.1 68.1 00.1 3 must precede the rule that drops 
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the remainder of the subnet. 

To insert a rule in a specific location in an existing chain, use the -i option. For 
example: 

[root@myServer ~ ] # iptables -I INPUT 1 -i lo -p all -j ACCEPT 

This rule is inserted as the first rule in the INPUT chain to allow local loopback 
device traffic. 



There may be times when you require remote access to the LAN. Secure services, for example 
SSH, can be used for encrypted remote connection to LAN services. 

Administrators with PPP-based resources (such as modem banks or bulk ISP accounts), dial-up 
access can be used to securely circumvent firewall barriers. Because they are direct 
connections, modem connections are typically behind a firewall/gateway. 



For remote users with broadband connections, however, special cases can be made. You can 
configure iptables to accept connections from remote SSH clients. For example, the following 
rules allow remote SSH access: 



[ rootSmyServer ~ ' 


I # iptables 


-A INPUT -p tcp 


-dport 22 -j ACCEPT 


[ root@myServer ~ ' 


I # iptables 


-A OUTPUT -p tcp - 


—sport 22 -j ACCEPT 



These rules allow incoming and outbound access for an individual system, such as a single PC 
directly connected to the Internet or a firewall/gateway. However, they do not allow nodes 
behind the firewall/gateway to access these services. To allow LAN access to these services, 
you can use Network Address Translation (NAT) with iptables filtering rules. 

3. forward and NAT Rules 

Most ISPs provide only a limited number of publicly routable IP addresses to the organizations 
they serve. 

Administrators must, therefore, find alternative ways to share access to Internet services without 
giving public IP addresses to every node on the LAN. Using private IP addresses is the most 
common way of allowing all nodes on a LAN to properly access internal and external network 
services. 

Edge routers (such as firewalls) can receive incoming transmissions from the Internet and route 
the packets to the intended LAN node. At the same time, firewalls/gateways can also route 
outgoing requests from a LAN node to the remote Internet service. 
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This forwarding of network traffic can become dangerous at times, especially with the availability 
of modern cracking tools that can spoof internal IP addresses and make the remote attacker's 
machine act as a node on your LAN. 

To prevent this, iptabies provides routing and forwarding policies that can be implemented to 
prevent abnormal usage of network resources. 



The forward chain allows an administrator to control where packets can be routed within a 
LAN. For example, to allow forwarding for the entire LAN (assuming the firewall/gateway is 
assigned an internal IP address on eth1), use the following rules: 



[ root@myServer ~ ' 


I # iptabies 


-A FORWARD 


-i ethl 


-j ACCEPT 


[ root@myServer ~ ' 


I # iptabies 


-A FORWARD 


-o ethl 


-j ACCEPT 



This rule gives systems behind the firewall/gateway access to the internal network. The gateway 
routes packets from one LAN node to its intended destination node, passing all packets through 
its ethi device. 



Note 

By default, the IPv4 policy in Red Hat Enterprise Linux kernels disables support 
for IP forwarding. This prevents machines that run Red Hat Enterprise Linux from 
functioning as dedicated edge routers. To enable IP forwarding, use the following 
command: 

[ root@myServer ~ ] # sysctl -w net . ipv4 . ip_f orward=l 

This configuration change is only valid for the current session; it does not persist 
beyond a reboot or network service restart. To permanently set IP forwarding, 
edit the /etc/syscti . conf file as follows: 

Locate the following line: 

net . ipv4 . ip_f orward = 

Edit it to read as follows: 

net . ipv4 . ip_f orward = 1 

Use the following command to enable the change to the syscti . conf file: 
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[root@myServer ~ ] # sysctl -p /etc/sysctl . conf 



5.1. Postrouting and IP Masquerading 

Accepting forwarded packets via the firewall's internal IP device allows LAN nodes to 
communicate with each other; however they still cannot communicate externally to the Internet. 

To allow LAN nodes with private IP addresses to communicate with external public networks, 
configure the firewall for IP masquerading, which masks requests from LAN nodes with the IP 
address of the firewall's external device (in this case, ethO): 

[root@myServer ~ ] # iptables -t nat -A POSTROUTING -o ethO -j MASQUERADE 

This rule uses the NAT packet matching table (-t nat) and specifies the built-in 
POSTROUTING chain for NAT (-a postrouting) on the firewall's external networking device 

(-o ethO). 

POSTROUTING allows packets to be altered as they are leaving the firewall's external device. 

The - j masquerade target is specified to mask the private IP address of a node with the 
external IP address of the firewall/gateway. 

5.2. Prerouting 

If you have a server on your internal network that you want make available externally, you can 
use the - j dnat target of the PREROUTING chain in NAT to specify a destination IP address 
and port where incoming packets requesting a connection to your internal service can be 
forwarded. 

For example, if you want to forward incoming HTTP requests to your dedicated Apache HTTP 
Server at 1 72.31 .0.23, use the following command: 

[root@myServer ~ ] # iptables -t nat -A PREROUTING -i ethO -p tcp — dport 80 
-j DNAT — to 172.31.0.23:80 

This rule specifies that the nat table use the built-in PREROUTING chain to forward incoming 
HTTP requests exclusively to the listed destination IP address of 172.31.0.23. 
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Note 



If you have a default policy of DROP in your FORWARD chain, you must append 
a rule to forward all incoming HTTP requests so that destination NAT routing is 
possible. To do this, use the following command: 



[root@myServer ~ ] # iptables -A FORWARD -i ethO -p tcp — dport 80 -d 
172.31.0.23 -j ACCEPT 



This rule forwards all incoming HTTP requests from the firewall to the intended 
destination; the Apache HTTP Server behind the firewall. 



5.3. DMZs and IPTables 

You can create iptables rules to route traffic to certain machines, such as a dedicated HTTP 
or FTP server, in a demilitarized zone (DMZ). A DMZ is a special local subnetwork dedicated to 
providing services on a public carrier, such as the Internet. 

For example, to set a rule for routing incoming HTTP requests to a dedicated HTTP server at 
10.0.4.2 (outside of the 192.168.1.0/24 range of the LAN), NAT uses the prerouting table to 
forward the packets to the appropriate destination: 



[root@myServer ~ ] # iptables -t nat -A PREROUTING -i ethO -p tcp — dport 80 
-j DNAT — to-destination 10.0.4.2:80 



With this command, all HTTP connections to port 80 from outside of the LAN are routed to the 
HTTP server on a network separate from the rest of the internal network. This form of network 
segmentation can prove safer than allowing HTTP connections to a machine on the network. 

If the HTTP server is configured to accept secure connections, then port 443 must be forwarded 
as well. 

6. Malicious Software and Spoofed IP Addresses 

More elaborate rules can be created that control access to specific subnets, or even specific 
nodes, within a LAN. You can also restrict certain dubious applications or programs such as 
trojans, worms, and other client/server viruses from contacting their server. 

For example, some trojans scan networks for services on ports from 31337 to 31340 (called the 
elite ports in cracking terminology). 

Since there are no legitimate services that communicate via these non-standard ports, blocking 
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them can effectively diminish the chances that potentially infected nodes on your network 
independently communicate with their remote master servers. 



The following rules drop all TCP traffic that attempts to use port 31 337: 



[ root@myServer ~ 


] # iptables 


-A OUTPUT - 


-o ethO -p tcp - 


-dport 31337 — sport 


31337 -j DROP 










[root@myServer ~ 


] # iptables 


-A FORWARD 


-o ethO -p tcp 


— dport 31337 


— sport 31337 -j 


DROP 









You can also block outside connections that attempt to spoof private IP address ranges to 
infiltrate your LAN. 

For example, if your LAN uses the 1 92.1 68.1 .0/24 range, you can design a rule that instructs 
the Internet-facing network device (for example, ethO) to drop any packets to that device with an 
address in your LAN IP range. 

Because it is recommended to reject forwarded packets as a default policy, any other spoofed 
IP address to the external-facing device (ethO) is rejected automatically. 

[root@myServer ~ ] # iptables -A FORWARD -s 192.168.1.0/24 -i ethO -j DROP 



Note 

There is a distinction between the drop and reject targets when dealing with 
appended rules. 

The reject target denies access and returns a connection refused error to 
users who attempt to connect to the service. The drop target, as the name 
implies, drops the packet without any warning. 

Administrators can use their own discretion when using these targets. However, 
to avoid user confusion and attempts to continue connecting, the reject target 
is recommended. 



7. IPTables and Connection Tracking 

You can inspect and restrict connections to services based on their connection state. A module 
within iptables uses a method called connection tracking to store information about incoming 
connections. You can allow or deny access based on the following connection states: 

• new — A packet requesting a new connection, such as an HTTP request. 
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• established — A packet that is part of an existing connection. 

• related — A packet that is requesting a new connection but is part of an existing connection. 
For example, FTP uses port 21 to establish a connection, but data is transferred on a different 
port (typically port 20). 

• invalid — A packet that is not part of any connections in the connection tracking table. 

You can use the stateful functionality of iptabies connection tracking with any network 
protocol, even if the protocol itself is stateless (such as UDP). The following example shows a 
rule that uses connection tracking to forward only the packets that are associated with an 
established connection: 



[root@myServer ~ ] # 


iptabies -A FORWARD -m state - 


— state 


ESTABLISHED, related - 


-j ACCEPT 





8. IPv6 

The introduction of the next-generation Internet Protocol, called IPv6, expands beyond the 
32-bit address limit of IPv4 (or IP). IPv6 supports 128-bit addresses, and carrier networks that 
are IPv6 aware are therefore able to address a larger number of routable addresses than IPv4. 

Red Hat Enterprise Linux supports IPv6 firewall rules using the Netfilter 6 subsystem and the 
ip6tabies command. In Red Hat Enterprise Linux 5, both IPv4 and IPv6 services are enabled 
by default. 

The ip6tabies command syntax is identical to iptabies in every aspect except that it supports 
128-bit addresses. For example, use the following command to enable SSH connections on an 
IPv6-aware network server: 

[root§myServer ~ ] # ip6tables -A INPUT -i ethO -p tcp -s 
3f fe : ffff: 100 :: 1/128 — dport 22 -j ACCEPT 

For more information about IPv6 networking, refer to the IPv6 Information Page at 

http://www. ipv6. org/. 

9. Additional Resources 

There are several aspects to firewalls and the Linux Netfilter subsystem that could not be 
covered in this chapter. For more information, refer to the following resources. 

9.1. Installed Documentation 
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• The iptabies man page contains a brief summary of the various options. 

9.2. Useful Websites 

• http://www.netfilter.org/ — The official homepage of the Netfilter and iptabies project. 

• http://www.tldp.org/ — The Linux Documentation Project contains several useful guides 
relating to firewall creation and administration. 

• http://www.iana.org/assignments/port-numbers — The official list of registered and common 
service ports as assigned by the Internet Assigned Numbers Authority. 

9.3. Related Documentation 



• Red Hat Linux Firewalls, by Bill McCarty; Red Hat Press — a comprehensive reference to 
building network and server firewalls using open source packet filtering technology such as 
Netfilter and iptabies. It includes topics that cover analyzing firewall logs, developing firewall 
rules, and customizing your firewall using various graphical tools. 

• Linux Firewalls, by Robert Ziegler; New Riders Press — contains a wealth of information on 
building firewalls using both 2.2 kernel ipchains as well as Netfilter and iptabies. Additional 
security topics such as remote access issues and intrusion detection systems are also 
covered. 
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Controlling Access to Services 

Maintaining security on your system is extremely important, and one approach for this task is to 
manage access to system services carefully. Your system may need to provide open access to 
particular services (for example, httpd if you are running a Web server). However, if you do not 
need to provide a service, you should turn it off to minimize your exposure to possible bug 
exploits. 

There are several different methods for managing access to system services. Decide which 
method of management to use based on the service, your system's configuration, and your level 
of Linux expertise. 

The easiest way to deny access to a service is to turn it off. Both the services managed by 
xinetd and the services in the /etc/rc . d/init . d hierarchy (also known as SysV services) 
can be configured to start or stop using three different applications: 

• Services Configuration Tool — a graphical application that displays a description of each 
service, displays whether each service is started at boot time (for runlevels 3, 4, and 5), and 
allows services to be started, stopped, and restarted. 

• ntsysv — a text-based application that allows you to configure which services are started at 
boot time for each runlevel. Non-xinetd services can not be started, stopped, or restarted 
using this program. 

• chkconf ig — a command line utility that allows you to turn services on and off for the 
different runlevels. Non-xinetd services can not be started, stopped, or restarted using this 
utility. 

You may find that these tools are easier to use than the alternatives — editing the numerous 
symbolic links located in the directories below /etc/red by hand or editing the xinetd 
configuration files in /etc/xinetd.d. 

Another way to manage access to system services is by using iptabies to configure an IP 
firewall. If you are a new Linux user, please realize that iptabies may not be the best solution 
for you. Setting up iptabies can be complicated and is best tackled by experienced Linux 
system administrators. 

On the other hand, the benefit of using iptabies is flexibility. For example, if you need a 
customized solution which provides certain hosts access to certain services, iptabies can 
provide it for you. Refer to the Red Hat Enterprise Linux Reference Guide and the Red Hat 
Enterprise Linux Security Guide for more information about iptabies. 

Alternatively, if you are looking for a utility to set general access rules for your home machine, 
and/or if you are new to Linux, try the Security Level Configuration Tool 
(system-conf ig-securityievei), which allows you to select the security level for your system, 
similar to the Firewall Configuration screen in the installation program. 
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If you need more specific firewall rules, refer to the iptabies chapter in the Red Hat Enterprise 
Linux Reference Guide. 

1. Runlevels 

Before you can configure access to services, you must understand Linux runlevels. A runlevel is 
a state, or mode, that is defined by the services listed in the directory /etc/rc.d/rc<x>.d, 
where <x> is the number of the runlevel. 

The following runlevels exist: 



• — Halt 

• 1 — Single-user mode 

• 2 — Not used (user-definable) 

• 3 — Full multi-user mode 

• 4 — Not used (user-definable) 

• 5 — Full multi-user mode (with an X-based login screen) 

• 6 — Reboot 

If you use a text login screen, you are operating in runlevel 3. If you use a graphical login 
screen, you are operating in runlevel 5. 

The default runlevel can be changed by modifying the /etc/inittab file, which contains a line 
near the top of the file similar to the following: 

id: 5 : initdef ault : 

Change the number in this line to the desired runlevel. The change does not take effect until 
you reboot the system. 

To change the runlevel immediately, use the command teiinit followed by the runlevel 
number. You must be root to use this command. The teiinit command does not change the 
/etc/inittab file; it only changes the runlevel currently running. When the system is rebooted, 
it continues to boot the runlevel as specified in /etc/inittab. 

2. TCP Wrappers 

Many UNIX system administrators are accustomed to using TCP wrappers to manage access to 
certain network services. Any network services managed by xinetd (as well as any program 
with built-in support for libwrap) can use TCP wrappers to manage access, xinetd can use 
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the /etc/hosts . allow and /etc/hosts . deny files to configure access to system services. As 
the names imply, hosts . allow contains a list of rules that allow clients to access the network 
services controlled by xinetd, and hosts . deny contains rules to deny access. The 
hosts . allow file takes precedence over the hosts . deny file. Permissions to grant or deny 
access can be based on individual IP address (or hostnames) or on a pattern of clients. Refer to 
the Red Hat Enterprise Linux Reference Guide and hosts_access in section 5 of the man 
pages (man 5 hosts_access) for details. 

2.1 . xinetd 

To control access to Internet services, use xinetd, which is a secure replacement for inetd. 
The xinetd daemon conserves system resources, provides access control and logging, and 
can be used to start special-purpose servers, xinetd can be used to provide access only to 
particular hosts, to deny access to particular hosts, to provide access to a service at certain 
times, to limit the rate of incoming connections and/or the load created by connections, and 
more 

xinetd runs constantly and listens on all ports for the services it manages. When a connection 
request arrives for one of its managed services, xinetd starts up the appropriate server for that 
service. 

The configuration file for xinetd is /etc/xinetd. conf , but the file only contains a few defaults 
and an instruction to include the /etc/xinetd. d directory. To enable or disable an xinetd 
service, edit its configuration file in the /etc/xinetd. d directory. If the disable attribute is set 
to yes, the service is disabled. If the disable attribute is set to no, the service is enabled. You 
can edit any of the xinetd configuration files or change its enabled status using the Services 
Configuration Tool, ntsysv, or chkconf ig. For a list of network services controlled by xinetd, 
review the contents of the /etc/xinetd. d directory with the command is /etc/xinetd. d. 

3. Services Configuration Tool 

The Services Configuration Tool is a graphical application developed by Red Hat to configure 
which SysV services in the /etc/rc . d/init . d directory are started at boot time (for runlevels 
3, 4, and 5) and which xinetd services are enabled. It also allows you to start, stop, and restart 
SysV services as well as restart xinetd. 

To start the Services Configuration Tool from the desktop, go to the Main Menu Button (on 
the Panel) => System Settings => Server Settings => Services or type the command 
system-conf ig-services at a shell prompt (for example, in an XTerm or a GNOME terminal). 
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File Actions 



Edit Runlevel Help 



> © 

Start Stop Restart Save Revert 
Currently Running in Runlevel: 5 Editing Runlevel: 5 

crond 



E3 cups 



□ cups-lpd 

□ daytime 

D daytirne-udp 

□ dbskkd-cdb 

□ dhcpd 

□ dhcrelay 

□ echo 

D echo-udp 

□ eklogin 

□ finger 

□ firstboot 
gprn 

□ gssftp 
hpoj 

□ httpd 

□ identd 



Description 



Startup/shutdown script for the Common UNIX 
Printing System (CUPS). 




Figure 19.1. Services Configuration Tool 



The Services Configuration Tool displays the current runlevel as well as the runlevel you are 
currently editing. To edit a different runlevel, select Edit Runlevel from the pulldown menu and 
select runlevel 3, 4, or 5. Refer to Section 1, "Runlevels"tor a description of runlevels. 

The Services Configuration Tool lists the services from the /etc/rc . d/init . d directory as 
well as the services controlled by xinetd. Click on the name of the service from the list on the 
left-hand side of the application to display a brief description of that service as well as the status 
of the service. If the service is not an xinetd service, the status window shows whether the 
service is currently running. If the service is controlled by xinetd, the status window displays 
the phrase xinetd service. 

To start, stop, or restart a service immediately, select the service from the list and click the 
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appropriate button on the toolbar (or choose the action from the Actions pulldown menu). If the 
service is an xinetd service, the action buttons are disabled because they can not be started or 
stopped individually. 

If you enable/disable an xinetd service by checking or unchecking the checkbox next to the 
service name, you must select File => Save Changes from the pulldown menu to restart 
xinetd and immediately enable/disable the xinetd service that you changed, xinetd is also 
configured to remember the setting. You can enable/disable multiple xinetd services at a time 
and save the changes when you are finished. 

For example, assume you check rsync to enable it in runlevel 3 and then save the changes. 
The rsync service is immediately enabled. The next time xinetd is started, rsync is still 
enabled. 



A 



Warning 

When you save changes to xinetd services, xinetd is restarted, and the 
changes take place immediately. When you save changes to other services, the 
runlevel is reconfigured, but the changes do not take effect immediately. 



To enable a non-xinetd service to start at boot time for the currently selected runlevel, check 
the checkbox beside the name of the service in the list. After configuring the runlevel, apply the 
changes by selecting File => Save Changes from the pulldown menu. The runlevel 
configuration is changed, but the runlevel is not restarted; thus, the changes do not take place 
immediately. 

For example, assume you are configuring runlevel 3. If you change the value for the httpd 
service from checked to unchecked and then select Save Changes, the runlevel 3 configuration 
changes so that httpd is not started at boot time. However, runlevel 3 is not reinitialized, so 
httpd is still running. Select one of following options at this point: 



1 . Stop the httpd service — Stop the service by selecting it from the list and clicking the Stop 
button. A message appears stating that the service was stopped successfully. 

2. Reinitialize the runlevel — Reinitialize the runlevel by going to a shell prompt and typing the 
command teiinit 3 (where 3 is the runlevel number). This option is recommended if you 
change the Start at Boot value of multiple services and want to activate the changes 
immediately. 

3. Do nothing else — You do not have to stop the httpd service. You can wait until the system 
is rebooted for the service to stop. The next time the system is booted, the runlevel is 
initialized without the httpd service running. 

To add a service to a runlevel, select the runlevel from the Edit Runlevel pulldown menu, and 
then select Actions => Add Service. To delete a service from a runlevel, select the runlevel 
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from the Edit Runlevel pulldown menu, select the service to be deleted from the list on the left, 
and select Actions => Delete Service. 

4. ntsysv 

The ntsysv utility provides a simple interface for activating or deactivating services. You can 
use ntsysv to turn an xinetd-managed service on or off. You can also use ntsysv to configure 
runlevels. By default, only the current runlevel is configured. To configure a different runlevel, 
specify one or more runlevels with the — level option. For example, the command ntsysv 
— level 345 configures runlevels 3, 4, and 5. 

The ntsysv interface works like the text mode installation program. Use the up and down 
arrows to navigate up and down the list. The space bar selects/unselects services and is also 
used to "press" the Ok and Cancel buttons. To move between the list of services and the Ok 
and Cancel buttons, use the Tab key. A * signifies that a service is set to on. Pressing the F1 
key displays a short description of the selected service. 




Warning 

Services managed by xinetd are immediately affected by ntsysv. For all other 



services, changes do not take effect immediately. You must stop or start the 
individual service with the command service daemon stop. In the previous 
example, replace daemon with the name of the service you want to stop; for 
example, httpd. Replace stop with start or restart to start or restart the 
service. 



5m chkconfig 

The chkconfig command can also be used to activate and deactivate services. The chkconfig 
—list command displays a list of system services and whether they are started (on) or 
stopped (off) in runlevels 0-6. At the end of the list is a section for the services managed by 

xinetd. 

If the chkconfig — list command is used to query a service managed by xinetd, it displays 
whether the xinetd service is enabled (on) or disabled (off). For example, the command 
chkconfig — list finger returns the following output: 

finger on 



As shown, finger is enabled as an xinetd service. If xinetd is running, finger is enabled. 

If you use chkconfig — list to query a service in /etc/rc . d, service's settings for each 
runlevel are displayed. For example, the command chkconfig —list httpd returns the 
following output: 
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httpd 


0:off 


l:off 


2 : on 


3 : on 


4 : on 


5 : on 


6: off 



chkconf ig can also be used to configure a service to be started (or not) in a specific runlevel. 
For example, to turn nscd off in runlevels 3, 4, and 5, use the following command: 

chkconfig — level 345 nscd off 



Warning 

Services managed by xinetd are immediately affected by chkconfig. For 
example, if xinetd is running, finger is disabled, and the command chkconfig 
finger on is executed, finger is immediately enabled without having to restart 
xinetd manually. Changes for other services do not take effect immediately after 
using chkconfig. You must stop or start the individual service with the command 
service daemon stop. In the previous example, replace daemon with the name 
of the service you want to stop; for example, httpd. Replace stop with start or 
restart to start or restart the service. 



6. Additional Resources 

For more information, refer to the following resources. 

6.1. Installed Documentation 

• The man pages for ntsysv, chkconfig, xinetd, and xinetd. conf. 

• man 5 hosts_access — The man page for the format of host access control files (in section 
5 of the man pages). 

6.2. Useful Websites 

• http://www.xinetd.org — The xinetd webpage. It contains a more detailed list of features and 
sample configuration files. 

6.3. Related Books 

• Red Hat Enterprise Linux Reference Guide , Red Hat, Inc. — This companion manual 
contains detailed information about how TCP wrappers and xinetd allow or deny access as 
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well as how to configure network access using them. It also provides instructions for creating 
iptabies firewall rules. 

• Red Hat Enterprise Linux Security Guide Red Hat, Inc. — This manual discusses securing 
services with TCP wrappers and xinetd such as logging denied connection attempts. 
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OpenSSH 

OpenSSH is a free, open source implementation of the SSH (S ecure SH ell) protocols. It 
replaces telnet, ftp, riogin, rsh, and rep with secure, encrypted network connectivity tools. 
OpenSSH supports versions 1 .3, 1 .5, and 2 of the SSH protocol. Since OpenSSH version 2.9, 
the default protocol is version 2, which uses RSA keys as the default. 

1. Why Use OpenSSH? 

If you use OpenSSH tools, you are enhancing the security of your machine. All communications 
using OpenSSH tools, including passwords, are encrypted. Telnet and ftp use plain text 
passwords and send all information unencrypted. The information can be intercepted, the 
passwords can be retrieved, and your system could be compromised by an unauthorized 
person logging in to your system using one of the intercepted passwords. The OpenSSH set of 
utilities should be used whenever possible to avoid these security problems. 

Another reason to use OpenSSH is that it automatically forwards the display variable to the 
client machine. In other words, if you are running the X Window System on your local machine, 
and you log in to a remote machine using the ssh command, when you run a program on the 
remote machine that requires X, it will be displayed on your local machine. This feature is 
convenient if you prefer graphical system administration tools but do not always have physical 
access to your server. 

2. Configuring an OpenSSH Server 

To run an OpenSSH server, you must first make sure that you have the proper RPM packages 
installed. The openssh-server package is required and depends on the openssh package. 

The OpenSSH daemon uses the configuration file /etc/ssh/sshd_conf ig. The default 
configuration file should be sufficient for most purposes. If you want to configure the daemon in 
ways not provided by the default sshd_conf ig, read the sshd man page for a list of the 
keywords that can be defined in the configuration file. 

To start the OpenSSH service, use the command /sbin/service sshd start. To stop the 
OpenSSH server, use the command /sbin/service sshd stop. If you want the daemon to 
start automatically at boot time, refer to Chapter 19, Controlling Access to Services for 
information on how to manage services. 



If you reinstall, the reinstalled system creates a new set of identification keys. Any clients who 
had connected to the system with any of the OpenSSH tools before the reinstall will see the 
following message: 



@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 


@@( 


a@@@ 


@ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! 




@ 


@@@@@@@@@@@@@@@@@@@@@@@@@@@@^ 


@@( 




IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY! 






Someone could be eavesdropping on you right now (man- 


in- 


-the-middle attack) ! 
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It is also possible that the RSA host key has just been changed. 

If you want to keep the host keys generated for the system, backup the 
/etc/ssh/ssh_host*key* files and restore them after the reinstall. This process retains the 
system's identity, and when clients try to connect to the system after the reinstall, they will not 
receive the warning message. 

3. Configuring an OpenSSH Client 

To connect to an OpenSSH server from a client machine, you must have the openssh-ciients 
and openssh packages installed on the client machine. 

3.1. Using the SS h Command 

The ssh command is a secure replacement for the riogin, rsh, and telnet commands. It 
allows you to log in to a remote machine as well as execute commands on a remote machine. 

Logging in to a remote machine with ssh is similar to using telnet. To log in to a remote 
machine named penguin.example.net, type the following command at a shell prompt: 

ssh penguin.example.net 



The first time you ssh to a remote machine, you will see a message similar to the following: 



The 


authenticity of host 'penguin.example.net' can't 


be 


established. 


DSA 


key fingerprint is 94 : 68 : 3a : 3a : be : f 3 : 9a : 9b : 1 : 5d : 


b3: 


:07:38:e2:ll:0c. 


Are 


you sure you want to continue connecting (yes/no) 


9 





Type yes to continue. This will add the server to your list of known hosts 

(-/ . ssh/known_hosts/) as seen in the following message: 

Warning: Permanently added 'penguin.example.net' (RSA) to the list of known 
hosts . 

Next, you will see a prompt asking for your password for the remote machine. After entering 
your password, you will be at a shell prompt for the remote machine. If you do not specify a 
username the username that you are logged in as on the local client machine is passed to the 
remote machine. If you want to specify a different username, use the following command: 

ssh username@penguin.example.net 
YOU Can alSO USe the Syntax ssh -1 username penguin.example.net. 
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The ssh command can be used to execute a command on the remote machine without logging 
in to a shell prompt. The syntax is ssh hostnamecommand. For example, if you want to execute 
the command is /usr/share/doc on the remote machine penguin.example.net, type the 
following command at a shell prompt: 

ssh penguin.example.net Is /usr/share/doc 

After you enter the correct password, the contents of the remote directory /usr/share/doc will 
be displayed, and you will return to your local shell prompt. 

3.2. Using the scp Command 

The scp command can be used to transfer files between machines over a secure, encrypted 
connection. It is similar to rep. 

The general syntax to transfer a local file to a remote system is as follows: 

scp <localfile>username@tohostname : <remotefile> 

The <iocaifiie> specifies the source including path to the file, such as / var / log /mail log. 
The <remotefiie> specifies the destination, which can be a new filename such as 
/tmp/hostname-maiiiog. For the remote system, if you do not have a preceding /, the path will 

be relative tO the home directory Of username, typically /home/username/. 

To transfer the local file shadowman to the home directory of your account on 
penguin.example.net, type the following at a shell prompt (replace username with your 
username): 

scp shadowman user.na.me@penguin . example . net : shadowman 
This Will transfer the local file shadowman tO /home/ username/ shadowman on 

penguin.example.net. Alternately, you can leave off the final shadowman in the scp command. 
The general syntax to transfer a remote file to the local system is as follows: 

scp username@tohostname : <remotefile><newlocalfile> 

The <remotefiie> specifies the source including path, and <newiocaifiie> specifies the 
destination including path. 

Multiple files can be specified as the source files. For example, to transfer the contents of the 
directory downloads/ to an existing directory called uploads/ on the remote machine 
penguin.example.net, type the following at a shell prompt: 

scp downloads/* usernarae@penguin . example . net : uploads/ 
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3.3. Using the sftp Command 

The sftp utility can be used to open a secure, interactive FTP session. It is similar to ftp 
except that it uses a secure, encrypted connection. The general syntax is sftp 
username@hostname . com. Once authenticated, you can use a set of commands similar to those 
used by FTP. Refer to the sftp man page for a list of these commands. To read the man page, 
execute the command man sftp at a shell prompt. The sftp utility is only available in 
OpenSSH version 2.5.0p1 and higher. 

3.4. Generating Key Pairs 

If you do not want to enter your password every time you use ssh, scp, or sftp to connect to a 
remote machine, you can generate an authorization key pair. 

Keys must be generated for each user. To generate keys for a user, use the following steps as 
the user who wants to connect to remote machines. If you complete the steps as root, only root 
will be able to use the keys. 

Starting with OpenSSH version 3.0, -/ . ssh/authorized_keys2, -/ . ssh/known_hosts2, and 
/etc/ssh_known_hosts2 are obsolete. SSH Protocol 1 and 2 share the 

~/ . ssh/ authorized_keys, ~/ . ssh/known_hosts, and / etc/ssh/ssh_known_hosts files. 

Red Hat Enterprise Linux 5.0.0 uses SSH Protocol 2 and RSA keys by default. 



Tip 

If you reinstall and want to save your generated key pair, backup the .ssh 
directory in your home directory. After reinstalling, copy this directory back to 
your home directory. This process can be done for all users on your system, 
including root. 



3.4.1. Generating an RSA Key Pair for Version 2 

Use the following steps to generate an RSA key pair for version 2 of the SSH protocol. This is 
the default starting with OpenSSH 2.9. 



1 . To generate an RSA key pair to work with version 2 of the protocol, type the following 
command at a shell prompt: 

ssh-keygen -t rsa 

Accept the default file location of -/ . ssh/id_rsa. Enter a passphrase different from your 
account password and confirm it by entering it again. 
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The public key is written to -/ . ssh/id_rsa.pub. The private key is written to 
-/ . ssh/id_rsa. Never distribute your private key to anyone. 

2. Change the permissions of the . ssh directory using the following command: 

chmod 755 ~/.ssh 

3. Copy the Contents Of -/ . ssh/id_rsa.pub into the file -/ . ssh/authorized_keys on the 

machine to which you want to connect. If the file -/ . ssh/authorized_keys exist, append the 
contents of the file -/ . ssh/id_rsa.pub to the file -/ . ssh/authorized_keys on the other 
machine. 

4. Change the permissions of the authorized_keys file using the following command: 

chmod 644 -/ . ssh/authorized_keys 

5. If you are running GNOME, skip to Section 3.4.4, "Configuring ssh-agent with GNOME". If 
you are not running the X Window System, skip to Section 3.4.5, "Configuring ssh-agent". 

3.4.2. Generating a DSA Key Pair for Version 2 

Use the following steps to generate a DSA key pair for version 2 of the SSH Protocol. 



1 . To generate a DSA key pair to work with version 2 of the protocol, type the following 
command at a shell prompt: 

ssh-keygen -t dsa 

Accept the default file location of -/ . ssh/id_dsa. Enter a passphrase different from your 
account password and confirm it by entering it again. 



Tip 

A passphrase is a string of words and characters used to authenticate a user. 
Passphrases differ from passwords in that you can use spaces or tabs in the 
passphrase. Passphrases are generally longer than passwords because they are 
usually phrases instead of a single word. 



The public key is written to -/ . ssh/id_dsa.pub. The private key is written to 
-/ . ssh/id_dsa. It is important never to give anyone the private key. 

2. Change the permissions of the .ssh directory with the following command: 
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chmod 755 ~/.ssh 

3. Copy the Contents Of -/ . ssh/id_dsa.pub into the file -/ . ssh/authorized_keys on the 

machine to which you want to connect. If the file -/. ssh/authorized_keys exist, append the 
contents of the file -/ . ssh/id_dsa.pub to the file -/ . ssh/authorized_keys on the other 
machine. 

4. Change the permissions of the authorized_keys file using the following command: 

chmod 644 -/ . ssh/authorized_keys 

5. If you are running GNOME, skip to Section 3.4.4, "Configuring ssh-agent with GNOME". If 
you are not running the X Window System, skip to Section 3.4.5, "Configuring ssh-agent". 

3.4.3. Generating an RSA Key Pair for Version 1.3 and 1.5 

Use the following steps to generate an RSA key pair, which is used by version 1 of the SSH 
Protocol. If you are only connecting between systems that use DSA, you do not need an RSA 
version 1 .3 or RSA version 1 .5 key pair. 

1 . To generate an RSA (for version 1 .3 and 1 .5 protocol) key pair, type the following command 
at a shell prompt: 

ssh-keygen -t rsal 

Accept the default file location (-/ . ssh/identity). Enter a passphrase different from your 
account password. Confirm the passphrase by entering it again. 

The public key is written to -/. ssh/identity .pub. The private key is written to 
-/ . ssh/identity. Do not give anyone the private key. 

2. Change the permissions of your . ssh directory and your key with the commands chmod 755 

-/. ssh and chmod 644 ~ /. ssh/identity . pub. 

3. Copy the Contents Of -/ . ssh/identity .pub into the file -/ . ssh/authorized_keys on the 

machine to which you wish to connect. If the file -/ . ssh/authorized_keys does not exist, 

you Can copy the file -/ . ssh/identity .pub to the file -/ . ssh/authorized_keys On the 

remote machine. 

4. If you are running GNOME, skip to Section 3.4.4, "Configuring ssh-agent with GNOME". If 
you are not running GNOME, skip to Section 3.4.5, "Configuring ssh-agent". 

3.4.4. Configuring ssh-agent with GNOME 
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The ssh-agent utility can be used to save your passphrase so that you do not have to enter it 
each time you initiate an ssh or scp connection. If you are using GNOME, the 
openssh-askpass-gnome package contains the application used to prompt you for your 
passphrase when you log in to GNOME and save it until you log out of GNOME. You will not 
have to enter your password or passphrase for any ssh or scp connection made during that 
GNOME session. If you are not using GNOME, refer to Section 3.4.5, "Configuring ssh-agent". 

To save your passphrase during your GNOME session, follow the following steps: 



1. You will need to have the package openssh-askpass-gnome installed; you can use the 
command rpm -q openssh-askpass-gnome to determine if it is installed or not. If it is not 
installed, install it from your Red Hat Enterprise Linux CD-ROM set, from a Red Hat FTP 
mirror site, or using Red Hat Network. 

2. Select Main Menu Button (on the Panel) => Preferences => More Preferences => 
Sessions, and click on the Startup Programs tab. Click Add and enter /usr/bin/ssh-add 
in the Startup Command text area. Set it a priority to a number higher than any existing 
commands to ensure that it is executed last. A good priority number for ssh-add is 70 or 
higher. The higher the priority number, the lower the priority. If you have other programs 
listed, this one should have the lowest priority. Click Close to exit the program. 

3. Log out and then log back into GNOME; in other words, restart X. After GNOME is started, a 
dialog box will appear prompting you for your passphrase(s). Enter the passphrase 
requested. If you have both DSA and RSA key pairs configured, you will be prompted for 
both. From this point on, you should not be prompted for a password by ssh, scp, or sftp. 

3.4.5. Configuring ssh-agent 

The ssh-agent can be used to store your passphrase so that you do not have to enter it each 
time you make a ssh or scp connection. If you are not running the X Window System, follow 
these steps from a shell prompt. If you are running GNOME but you do not want to configure it 
to prompt you for your passphrase when you log in (refer to Section 3.4.4, "Configuring 
ssh-agent with GNOME'), this procedure will work in a terminal window, such as an XTerm. If 
you are running X but not GNOME, this procedure will work in a terminal window. However, 
your passphrase will only be remembered for that terminal window; it is not a global setting. 



1. At a shell prompt, type the following command: 

exec /usr/bin/ssh-agent $SHELL 

2. Then type the command: 

ssh-add 
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and enter your passphrase(s). If you have more than one key pair configured, you will be 
prompted for each one. 

3. When you log out, your passphrase(s) will be forgotten. You must execute these two 
commands each time you log in to a virtual console or open a terminal window. 

4. Additional Resources 

The OpenSSH and OpenSSL projects are in constant development, and the most up-to-date 
information for them is available from their websites. The man pages for OpenSSH and 
OpenSSL tools are also good sources of detailed information. 

4.1. Installed Documentation 



• The ssh, scp, sftp, sshd, and ssh-keygen man pages — These man pages include 
information on how to use these commands as well as all the parameters that can be used 
with them. 

4.2. Useful Websites 



• http://www.openssh.com/ — The OpenSSH FAQ page, bug reports, mailing lists, project 
goals, and a more technical explanation of the security features. 

• http://www.openssl.org/ — The OpenSSL FAQ page, mailing lists, and a description of the 
project goal. 

• http://www.freessh.org/ — SSH client software for other platforms. 

4.3. Related Books 



• Red Hat Enterprise Linux Reference Guide — Learn the event sequence of an SSH 
connection, review a list of configuration files, and discover how SSH can be used for X 
forwarding. 
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Network File System (NFS) 

Network File System (NFS) is a way to share files between machines on a network as if the files 
were located on the client's local hard drive. Red Hat Enterprise Linux can be both an NFS 
server and an NFS client, which means that it can export file systems to other systems and 
mount file systems exported from other machines. 

1. Why Use NFS? 

NFS is useful for sharing directories of files between multiple users on the same network. For 
example, a group of users working on the same project can have access to the files for that 
project using a shared directory of the NFS file system (commonly known as an NFS share) 
mounted in the directory /mypro ject. To access the shared files, the user goes into the 
/myproject directory on his machine. There are no passwords to enter or special commands to 
remember. Users work as if the directory is on their local machines. 

2. Mounting NFS File Systems 

Use the mount command to mount a shared NFS directory from another machine: 



mount shadowman . example . com : /mi sc /export /misc/ local 



Warning 



The mount point directory on the local machine (/misc/iocai in the above 
example) must exist before this command can be executed. 



In this command, shadowman . example . com is the hostname of the NFS file server, 
/misc/export is the directory that shadowman is exporting, and /misc/iocai is the location to 
mount the file system on the local machine. After the mount command runs (and if the client has 
proper permissions from the shadowman . example . com NFS server) the client user can execute 
the command is /misc/iocai to display a listing of the files in /misc/export on 

shadowman . example . com. 

2.1. Mounting NFS File Systems using /etc/f stab 

An alternate way to mount an NFS share from another machine is to add a line to the 
/etc/f stab file. The line must state the hostname of the NFS server, the directory on the 
server being exported, and the directory on the local machine where the NFS share is to be 
mounted. You must be root to modify the /etc/f stab file. 

The general syntax for the line in /etc/f stab is as follows: 
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server : /us r / local /pub 



/pub 



nf s 



rsize=8192,wsize=8192, t imeo=14 , intr 



The mount point /pub must exist on the client machine before this command can be executed. 
After adding this line to /etc/f stab on the client system, type the command mount /pub at a 
shell prompt, and the mount point /pub is mounted from the server. 

2.2. Mounting NFS File Systems using autofs 

A third option for mounting an NFS share is the use of the autofs service. Autofs uses the 
automount daemon to manage your mount points by only mounting them dynamically when 
they are accessed. 

Autofs consults the master map configuration file /etc/auto. master to determine which mount 
points are defined. It then starts an automount process with the appropriate parameters for each 
mount point. Each line in the master map defines a mount point and a separate map file that 
defines the file systems to be mounted under this mount point. For example, the 
/etc/auto. misc file might define mount points in the /misc directory; this relationship would be 
defined in the /etc/auto . master file. 

Each entry in auto .master has three fields. The first field is the mount point. The second field is 
the location of the map file, and the third field is optional. The third field can contain information 
such as a timeout value. 

For example, to mount the directory /pro j52 on the remote machine penguin.example.net at 
the mount point /misc/mypro ject on your machine, add the following line to auto. master: 



/misc /etc/auto .misc — timeout 60 



Next, add the following line to /etc/aut o . misc. 



mypro ject -rw, soft, intr, rsize=8192,wsize=8192 penguin. example .net : /proj52 



The first field in /etc/auto. misc is the name of the /misc subdirectory. This subdirectory is 
created dynamically by automount. It should not actually exist on the client machine. The 
second field contains mount options such as rw for read and write access. The third field is the 
location of the NFS export including the hostname and directory. 



Note 

The directory /misc must exist on the local file system. There should be no 
subdirectories in /misc on the local file system. 
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To start the autofs service, at a shell prompt, type the following command: 

/sbin/ service autofs restart 

To view the active mount points, type the following command at a shell prompt: 

/sbin/ service autofs status 

If you modify the /etc/auto .master configuration file while autofs is running, you must tell the 
automount daemon(s) to reload by typing the following command at a shell prompt: 



/sbin/service autofs reload 



To learn how to configure autofs to start at boot time, and for information on managing services, 
refer to Chapter 19, Controlling Access to Services. 

2.3. Using TCP 

The default transport protocol for NFSv4 is TCP; however, the Red Hat Enterprise Linux 5.0.0 
kernel includes support for NFS over UDP. To use NFS over UDP, include the -o udp option to 
mount when mounting the NFS-exported file system on the client system. 

There are three ways to configure an NFS file system export. On demand via the command line 
(client side), automatically via the /etc/f stab file (client side), and automatically via autofs 
configuration files, such as /etc/auto. master and /etc/auto .misc (server side with NIS). 

For example, on demand via the command line (client side): 

mount -o udp shadowman . example . com: /misc/export /misc/local 



When the NFS mount is specified in /etc/f stab (client side): 



server : /us r / local /pub 


/pub 


nf s 


rsize=8192, wsize=8192, 


timeo=l 4 , 


intr , udp 



When the NFS mount is specified in an autofs configuration file for a NIS server, available for 
NIS enabled workstations: 

mypro ject -rw, soft, intr, rsize=8192, wsize=8192, udp 
penguin . example .net:/proj52 

Since the default is TCP, if the -o udp option is not specified, the NFS-exported file system is 
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accessed via TCP. 

The advantages of using TCP include the following: 



• Improved connection durability, thus less nfs stale file handles messages. 

• Performance gain on heavily loaded networks because TCP acknowledges every packet, 
unlike UDP which only acknowledges completion. 

• TCP has better congestion control than UDP (which has none). On a very congested network, 
UDP packets are the first packets that are dropped. This means that if NFS is writing data (in 
8K chunks) all of that 8K must be retransmitted over UDP. Because of TCP's reliability, only 
parts of that 8K data are transmitted at a time. 

• Error detection. When a TCP connection breaks (due to the server being unavailable) the 
client stops sending data and restarts the connection process once the server becomes 
available. With UDP, since it's connection-less, the client continues to pound the network with 
data until the server reestablishes a connection. 

The main disadvantage is that there is a very small performance hit due to the overhead 
associated with the TCP protocol. 

2.4. Preserving ACLs 

The Red Hat Enterprise Linux 5.0.0 kernel provides ACL support for the ext3 file system and 
ext3 file systems mounted with the NFS or Samba protocols. Thus, if an ext3 file system has 
ACLs enabled for it and is NFS exported, and if the NFS client can read ACLs, they are used by 
the NFS client as well. 

For more information about mounting NFS file systems with ACLs, refer to Chapter 14, Access 
Control Lists. 

3. Exporting NFS File Systems 

Sharing or serving files from an NFS server is known as exporting the directories. The NFS 
Server Configuration Tool can be used to configure a system as an NFS server. 

To use the NFS Server Configuration Tool, you must be running the X Window System, have 
root privileges, and have the system-conf ig-nf s RPM package installed. To start the 
application, select the Main Menu Button (on the Panel) => System Settings => Server 

Settings => NFS, or type the command system-conf ig-nf s. 
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File Help 



Add Properties Delete 



Help 



Directory Hosts 



Permissions 



Figure 21.1. NFS Server Configuration Tool 



To add an NFS share, click the Add button. The dialog box shown in Figure 21.2, "Add Share" 
appears. 



The Basic tab requires the following information: 



Directory — Specify the directory to share, such as /tmp. 

Host(s) — Specify the host(s) with which to share the directory. Refer to Section 3.2, 
"Hostname Formats"\ox an explanation of possible formats. 

Basic permissions — Specify whether the directory should have read-only or read/write 
permissions. 



Basic 



General Options 



User Access 



Directory: /tmp 



Host(s): \ example, corn 



Browse. 



Basic permissions: 
"*■ Re ad -only 
O Read / Write 



>3 Cancel 



# OK 



Figure 21.2. Add Share 
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The General Options tab allows the following options to be configured: 



• Allow connections from port 1024 and higher — Services started on port numbers less 
than 1024 must be started as root. Select this option to allow the NFS service to be started by 
a user other than root. This option corresponds to insecure. 

• Allow insecure file locking — Do not require a lock request. This option corresponds to 

insecure_locks. 

• Disable subtree checking — If a subdirectory of a file system is exported, but the entire file 
system is not exported, the server checks to see if the requested file is in the subdirectory 
exported. This check is called subtree checking. Select this option to disable subtree 
checking. If the entire file system is exported, selecting to disable subtree checking can 
increase the transfer rate. This option corresponds to no_subtree_check. 

• Sync write operations on request — Enabled by default, this option does not allow the 
server to reply to requests before the changes made by the request are written to the disk. 
This option corresponds to sync. If this is not selected, the async option is used. 

• Force sync of write operations immediately — Do not delay writing to disk. This option 

Corresponds to no_wdelay. 

The User Access tab allows the following options to be configured: 



• Treat remote root user as local root — By default, the user and group IDs of the root user 
are both 0. Root squashing maps the user ID and the group ID to the user and group IDs 
of anonymous so that root on the client does not have root privileges on the NFS server. If 
this option is selected, root is not mapped to anonymous, and root on a client has root 
privileges to exported directories. Selecting this option can greatly decrease the security of 
the system. Do not select it unless it is absolutely necessary. This option corresponds to 

no_root_s quash. 

• Treat all client users as anonymous users — If this option is selected, all user and group 
IDs are mapped to the anonymous user. This option corresponds to aii_squash. 

• Specify local user ID for anonymous users — If Treat all client users as anonymous 
users is selected, this option lets you specify a user ID for the anonymous user. This option 

Corresponds tO anonuid. 

• Specify local group ID for anonymous users — If Treat all client users as anonymous 
users is selected, this option lets you specify a group ID for the anonymous user. This 

Option Corresponds tO anongid. 

To edit an existing NFS share, select the share from the list, and click the Properties button. To 
delete an existing NFS share, select the share from the list, and click the Delete button. 

After clicking OK to add, edit, or delete an NFS share from the list, the changes take place 
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immediately — the server daemon is restarted and the old configuration file is saved as 

/etc/exports .bak. The new configuration is written to /etc/exports. 

The NFS Server Configuration Tool reads and writes directly to the /etc/exports 

configuration file. Thus, the file can be modified manually after using the tool, and the tool can 
be used after modifying the file manually (provided the file was modified with correct syntax). 

3.1. Command Line Configuration 

If you prefer editing configuration files using a text editor or if you do not have the X Window 
System installed, you can modify the configuration file directly. 

The /etc/exports file controls what directories the NFS server exports. Its format is as follows: 

directory host name {options) 



The only option that needs to be specified is one of sync or async (sync is recommended). If 
sync is specified, the server does not reply to requests before the changes made by the request 
are written to the disk. 

For example, 

/misc/ export speedy . example . com ( sync) 



would allow users from speedy . example . com to mount /misc/export with the default 
read-only permissions, but, 

/misc/ export speedy . example . com ( rw, sync) 



would allow users from speedy . example . com to mount /misc/export with read/write 
privileges. 

Refer to Section 3.2, "Hostname Formats" tor an explanation of possible hostname formats. 

Refer to the Red Hat Enterprise Linux Reference Guide for a list of options that can be 
specified. 



Caution 



Be careful with spaces in the /etc/exports file. If there are no spaces between 
the hostname and the options in parentheses, the options apply only to the 
hostname. If there is a space between the hostname and the options, the options 
apply to the rest of the world. For example, examine the following lines: 



/misc/ export speedy . example . com (rw, sync) 
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/misc/export speedy.example.com (rw, sync) 

The first line grants users from speedy . example . com read-write access and 
denies all other users. The second line grants users from speedy.exampie.com 
read-only access (the default) and allows the rest of the world read-write access. 



Each time you change /etc/exports, you must inform the NFS daemon of the change, or 
reload the configuration file with the following command: 

/ sbin/service nfs reload 

3.2. Hostname Formats 

The host(s) can be in the following forms: 

• Single machine — A fully qualified domain name (that can be resolved by the server), 
hostname (that can be resolved by the server), or an IP address. 

• Series of machines specified with wildcards — Use the * or ? character to specify a string 
match. Wildcards are not to be used with IP addresses; however, they may accidentally work 
if reverse DNS lookups fail. When specifying wildcards in fully qualified domain names, dots 
(.) are not included in the wildcard. For example, * . example . com includes one.example.com 
but does not include one.two.example.com. 

• IP networks — Use a.b.c.d/z, where a.b. c. d is the network and z is the number of bits in 
the netmask (for example 192.168.0.0/24). Another acceptable format is a.b.c.d/netmask, 
where a . b . c. d is the network and netmask is the netmask (for example, 

1 92.1 68.1 00.8/255.255.255.0). 

• Netgroups — In the format @ group-name, where group-name I s the NIS netgroup name. 

3.3. Starting and Stopping the Server 

On the server that is exporting NFS file systems, the nfs service must be running. 
View the status of the NFS daemon with the following command: 

/sbin/service nfs status 

Start the NFS daemon with the following command: 

/sbin/service nfs start 
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Stop the NFS daemon with the following command: 

/ sbin/service nfs stop 

To start the nfs service at boot time, use the command: 

/ sbin/chkconf ig — level 345 nfs on 

You can also use chkconf ig, ntsysv or the Services Configuration Tool to configure which 
services start at boot time. Refer to Chapter 19, Controlling Access to Services tor details. 

4. Additional Resources 

This chapter discusses the basics of using NFS. For more detailed information, refer to the 
following resources. 

4.1. Installed Documentation 

• The man pages for nfsd, mountd, exports, auto. master, and autofs (in manual sections 5 
and 8) — These man pages show the correct syntax for the NFS and autofs configuration 
files. 

4.2. Useful Websites 

• http://nfs.sourceforge.net/ — the NFS webpage, includes links to the mailing lists and FAQs. 

• http://www.tldp.org/HOWTO/NFS-HOWTO/index.html— The Linux NFS-HOWTO from the 
Linux Documentation Project. 

4.3. Related Books 

• Managing NFS and NIS Services by Hal Stern; O'Reilly SAssociates, Inc. 
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Samba 

Samba uses the SMB protocol to share files and printers across a network connection. 
Operating systems that support this protocol include Microsoft Windows, OS/2, and Linux. 

The Red Hat Enterprise Linux 5.0.0 kernel contains Access Control List (ACL) support for ext3 
file systems. If the Samba server shares an ext3 file system with ACLs enabled for it, and the 
kernel on the client system contains support for reading ACLs from ext3 file systems, the client 
automatically recognizes and uses the ACLs. Refer to Chapter 14, Access Control Lists for 
more information on ACLs. 

1. Why Use Samba? 

Samba is useful if you have a network of both Windows and Linux machines. Samba allows files 
and printers to be shared by all the systems in a network. To share files between Linux 
machines only, use NFS as discussed in Chapter 21, Network File System (NFS). To share 
printers between Linux machines only, you do not need to use Samba; refer to Chapter 33, 
Printer Configuration. 

2. Configuring a Samba Server 

The default configuration file (/etc/samba/smb . conf ) allows users to view their home 
directories as a Samba share. It also shares all printers configured for the system as Samba 
shared printers. In other words, you can attach a printer to the system and print to it from the 
Windows machines on your network. 

2.1. Graphical Configuration 

To configure Samba using a graphical interface, use the Samba Server Configuration Tool. 

For command line configuration, skip to Section 2.2, "Command Line Configuration". 

The Samba Server Configuration Tool is a graphical interface for managing Samba shares, 
users, and basic server settings. It modifies the configuration files in the /etc/samba/ directory. 
Any changes to these files not made using the application are preserved. 

To use this application, you must be running the X Window System, have root privileges, and 
have the system-conf ig-samba RPM package installed. To start the Samba Server 
Configuration Tool from the desktop, go to the Main Menu Button (on the Panel) => System 
Settings => Server Settings => Samba or type the command system-conf ig-samba at a shell 
prompt (for example, in an XTerm or a GNOME terminal). 
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File Preferences Help 
Add Properties Delete Help 



Directory Permissions 



Description 



Figure 22.1. Samba Server Configuration Tool 



Note 

The Samba Server Configuration Tool does not display shared printers or the 
default stanza that allows users to view their own home directories on the Samba 
server. 



2.1.1. Configuring Server Settings 

The first step in configuring a Samba server is to configure the basic settings for the server and 
a few security options. After starting the application, select Preferences => Server Settings 
from the pulldown menu. The Basic tab is displayed as shown in Figure 22.2, "Configuring 
Basic Server Settings". 



Basic Security 




Workgroup: 
Description: 


my group | 


samba server 








U Cancel # OK 



232 



Graphical Configuration 



Figure 22.2. Configuring Basic Server Settings 



On the Basic tab, specify which workgroup the computer should be in as well as a brief 
description of the computer. They correspond to the workgroup and server string options in 

smb . conf. 



Basic 



Security 



Authentication Mode: 


User 


■¥■ 


Authentication Server: 




Kerberos Realm: 




Encrypt Passwords: 


Yes 


■¥■ 


Guest Account: 


No guest account 


■¥■ 



Cancel 



$ OK 



Figure 22.3. Configuring Security Server Settings 

The Security tab contains the following options: 



Authentication Mode — This corresponds to the security option. Select one of the 
following types of authentication. 

• ADS — The Samba server acts as a domain member in an Active Directory Domain (ADS) 
realm. For this option, Kerberos must be installed and configured on the server, and Samba 
must become a member of the ADS realm using the net utility, which is part of the 
samba-ciient package. Refer to the net man page for details. This option does not 
configure Samba to be an ADS Controller. Specify the realm of the Kerberos server in the 
Kerberos Realm field. 



Note 

V The Kerberos Realm field must be supplied in all uppercase letters, such as 

EXAMPLE . COM. 
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Use of your Samba server as a domain member in an ADS realm assumes 
proper configuration of Kerberos, including the /etc/krb5 . conf file. 



• Domain — The Samba server relies on a Windows NT Primary or Backup Domain 
Controller to verify the user. The server passes the username and password to the 
Controller and waits for it to return. Specify the NetBIOS name of the Primary or Backup 
Domain Controller in the Authentication Server field. 

The Encrypted Passwords option must be set to Yes if this is selected. 

• Server — The Samba server tries to verify the username and password combination by 
passing them to another Samba server. If it can not, the server tries to verify using the user 
authentication mode. Specify the NetBIOS name of the other Samba server in the 
Authentication Server field. 

• Share — Samba users do not have to enter a username and password combination on a 
per Samba server basis. They are not prompted for a username and password until they try 
to connect to a specific shared directory from a Samba server. 

• User — (Default) Samba users must provide a valid username and password on a per 
Samba server basis. Select this option if you want the Windows Username option to work. 
Refer to Section 2. 1.2, "Managing Samba Users" for details. 

• Encrypt Passwords — This option must be enabled if the clients are connecting from a 
system with Windows 98, Windows NT 4.0 with Service Pack 3, or other more recent versions 
of Microsoft Windows. The passwords are transfered between the server and the client in an 
encrypted format instead of as a plain-text word that can be intercepted. This corresponds to 

the encrypted passwords option. Refer to Section 2.3, "Encrypted Passwords" for more 
information about encrypted Samba passwords. 

• Guest Account — When users or guest users log into a Samba server, they must be 
mapped to a valid user on the server. Select one of the existing usernames on the system to 
be the guest Samba account. When guests log in to the Samba server, they have the same 
privileges as this user. This corresponds to the guest account option. 

After clicking OK, the changes are written to the configuration file and the daemon is restart; 
thus, the changes take effect immediately. 

2.1.2. Managing Samba Users 

The Samba Server Configuration Tool requires that an existing user account be active on the 
system acting as the Samba server before a Samba user can be added. The Samba user is 
associated with the existing user account. 
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Figure 22.4. Managing Samba Users 



To add a Samba user, select Preferences => Samba Users from the pulldown menu, and click 
the Add User button. In the Create New Samba User window select a Unix Username from 
the list of existing users on the local system. 

If the user has a different username on a Windows machine and needs to log into the Samba 
server from the Windows machine, specify that Windows username in the Windows Username 
field. The Authentication Mode on the Security tab of the Server Settings preferences must 
be set to User for this option to work. 

Also configure a Samba Password for the Samba User and confirm it by typing it again. Even if 
you select to use encrypted passwords for Samba, it is recommended that the Samba 
passwords for all users are different from their system passwords. 

To edit an existing user, select the user from the list, and click Edit User. To delete an existing 
Samba user, select the user, and click the Delete User button. Deleting a Samba user does not 
delete the associated system user account. 

The users are modified immediately after clicking the OK button. 

2.1.3. Adding a Share 

To create a Samba share, click the Add button from the main Samba configuration window. 
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Basic Access 




Directory: 


/docs-project 


Browse... 


Share name: 


docs-project 


Description: 


Shared Docs Project 


Basic Permissions: 
® ; Read -only; 
O Read / Write 


It Cancel 


$ OK 



Figure 22.5. Adding a Share 



The Basic tab configures the following options: 



• Directory — The directory to share via Samba. The directory must exist before it can be 
entered here. 

• Share name — The actual name of the share that is seen from remote machines. By default, 
it is the same value as Directory, but can be configured. 

• Descriptions — A brief description of the share. 

• Basic Permissions — Whether users should only be able to read the files in the shared 
directory or whether they should be able to read and write to the shared directory. 

On the Access tab, select whether to allow only specified users to access the share or whether 
to allow all Samba users to access the share. If you select to allow access to specific users, 
select the users from the list of available Samba users. 

The share is added immediately after clicking OK. 

2.2. Command Line Configuration 

Samba uses /etc/ samba/ smb. conf as its configuration file. If you change this configuration file, 
the changes do not take effect until you restart the Samba daemon with the command service 

smb restart. 
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To specify the Windows workgroup and a brief description of the Samba server, edit the 
following lines in your smb . conf file: 

workgroup = WORKGROUPNAME 

server string = BRIEF COMMENT ABOUT SERVER 

Replace workgroupname with the name of the Windows workgroup to which this machine 
should belong. The brief comment about server is optional and is used as the Windows 
comment about the Samba system. 

To create a Samba share directory on your Linux system, add the following section to your 
smb. conf file (after modifying it to reflect your needs and your system): 

[ sharename] 

comment = Insert a comment here 

path = /home/share/ 

valid users = tfox carole 

public = no 

writable = yes 

printable = no 

create mask = 0765 

The above example allows the users tfox and carole to read and write to the directory 
/home/share, on the Samba server, from a Samba client. 

2.3. Encrypted Passwords 

Encrypted passwords are enabled by default because it is more secure. If encrypted passwords 
are not used, plain text passwords are used, which can be intercepted by someone using a 
network packet sniffer. It is recommended that encrypted passwords be used. 

The Microsoft SMB Protocol originally used plain text passwords. However, Windows NT 4.0 
with Service Pack 3 or higher, Windows 98, Windows 2000, Windows ME, and Windows XP 
require encrypted Samba passwords. To use Samba between a Linux system and a system 
running one of these Windows operating systems, you can either edit your Windows registry to 
use plaintext passwords or configure Samba on your Linux system to use encrypted passwords. 
If you choose to modify your registry, you must do so for all of your Windows machines — this is 
risky and may cause further conflicts. It is recommended that you use encrypted passwords for 
better security. 

To configure Samba to use encrypted passwords, follow these steps: 



1. Create a separate password file for Samba. To create one based on your existing 
/etc/passwd file, at a shell prompt, type the following command: 
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cat /etc/passwd I mksmbpasswd . sh > /etc/ samba /smbpasswd 

If the system uses NIS, type the following command: 

ypcat passwd | mksmbpasswd. sh > /etc/samba/smbpasswd 

The mksmbpasswd. sh script is installed in your /usr/bin directory with the samba package. 

2. Change the permissions of the Samba password file so that only root has read and write 
permissions: 

chmod 600 /etc/samba/smbpasswd 

3. The script does not copy user passwords to the new file, and a Samba user account is not 
active until a password is set for it. For higher security, it is recommended that the user's 
Samba password be different from the user's system password. To set each Samba user's 
password, use the following command (replace username with each user's username): 

smbpasswd username 

4. Encrypted passwords must be enabled. Since they are enabled by default, they do not have 
to be specifically enabled in the configuration file. However, they can not be disabled in the 
configuration file either. In the file /etc/ samba/ smb. conf , verify that the following line does 
not exist: 

encrypt passwords = no 

If it does exist but is commented out with a semi-colon (; ) at the beginning of the line, then 
the line is ignored, and encrypted passwords are enabled. If this line exists but is not 
commented out, either remove it or comment it out. 



To specifically enable encrypted passwords in the configuration file, add the following lines to 

etc/ samba/ smb . conf: 



encrypt passwords 


= yes 


smb passwd file = 


/etc/samba/smbpasswd 



5. Make sure the smb service is started by typing the command service smb restart at a 
shell prompt. 

6. If you want the smb service to start automatically, use ntsysv, chkconf ig, or the Services 
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Configuration Tool to enable it at runtime. Refer to Chapter 19, Controlling Access to 
Services for details. 

The pam_smbpass PAM module can be used to sync users' Samba passwords with their system 
passwords when the passwd command is used. If a user invokes the passwd command, the 
password he uses to log in to the Red Hat Enterprise Linux system as well as the password he 
must provide to connect to a Samba share are changed. 

To enable this feature, add the following line to /etc/pam.d/system-auth below the 

pam_cracklib . so invocation: 

password required /lib/security/pam_smbpass . so nullok use_authtok 
try_f ir st_pass 

2.4. Starting and Stopping the Server 

On the server that is sharing directories via Samba, the smb service must be running. 
View the status of the Samba daemon with the following command: 

/ sbin/service smb status 

Start the daemon with the following command: 

/sbin/service smb start 

Stop the daemon with the following command: 

/sbin/service smb stop 

To start the smb service at boot time, use the command: 

/ sbin/chkconf ig — level 345 smb on 

You can also use chkconf ig, ntsysv, or the Services Configuration Tool to configure which 
services start at boot time. Refer to Chapter 19, Controlling Access to Services for details. 



Tip 

To view active connections to the system, execute the command smbstatus. 




239 



Chapter 22. Samba 



3. Connecting to a Samba Share 

You can use Nautilus to view available Samba shares on your network. Select Main Menu 
Button (on the Panel) => Network Servers to view a list of Samba workgroups on your 
network. You can also type smb: in the Location: bar of Nautilus to view the workgroups. 

As shown in Figure 22.6, "SMB Workgroups in Nautilus", an icon appears for each available 
SMB workgroup on the network. 
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Figure 22.6. SMB Workgroups in Nautilus 

Double-click one of the workgroup icons to view a list of computers within the workgroup. 



240 



Command Line 



File Edit View Go Bookmarks Help 



<] V [> V A0% H Q 



Back Forward Up Stop Reload Home 



smb://workgroup 



- irjrj + 



View as Icons 



FALCON PIGDOG PINKY YETI 



"WORKGROUP" selected (0 bytes) A 



Figure 22.7. SMB Machines in Nautilus 



As you can see from Figure 22.7, "SMB Machines in Nautilus", there is an icon for each 
machine within the workgroup. Double-click on an icon to view the Samba shares on the 
machine. If a username and password combination is required, you are prompted for them. 

Alternately, you can also specify the Samba server and sharename in the Location: bar for 
Nautilus using the following syntax (replace < server name> and <sh arename> with the 
appropriate values): 

smb : / / <servername> I <sharename>/ 



3.1. Command Line 

To query the network for Samba servers, use the f indsmb command. For each server found, it 
displays its IP address, NetBIOS name, workgroup name, operating system, and SMB server 
version. 

To connect to a Samba share from a shell prompt, type the following command: 

smbclient / / <hostname> I <sharename> -U <username> 
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Replace <hostname> with the hostname or IP address of the Samba server you want to connect 
to, <sharenawe> with the name of the shared directory you want to browse, and <username> 
with the Samba username for the system. Enter the correct password or press Enter if no 
password is required for the user. 

If you see the smb: \> prompt, you have successfully logged in. Once you are logged in, type 
help for a list of commands. If you wish to browse the contents of your home directory, replace 
sharename with your username. If the -u switch is not used, the username of the current user is 
passed to the Samba server. 

To exit smbciient, type exit at the smb: \> prompt. 

3.2. Mounting the Share 

Sometimes it is useful to mount a Samba share to a directory so that the files in the directory 
can be treated as if they are part of the local file system. 

To mount a Samba share to a directory, create the directory if it does not already exist, and 
execute the following command as root: 

mount -t smbfs -o username=<username> / / <servername>/ <sharename>/mnt/point/ 

This command mounts <sh arename> fro m <servername> in the local directory /mnt/point/. 

4. Additional Resources 

For configuration options not covered here, please refer to the following resources. 

4.1. Installed Documentation 

• smb . conf man page — explains how to configure the Samba configuration file 

• smbd man page — describes how the Samba daemon works 

• smbciient and f indsmb man pages — learn more about these client tools 

• /usr/share/doc/samba-<versiori-number>/docs/ — help files included with the samba 

package 

4.2. Useful Websites 

• http://www.samba.org/ — The Samba webpage contains useful documentation, information 
about mailing lists, and a list of GUI interfaces. 

• http://www.samba.org/samba/docs/using_samba/toc.html — an online version of Using 
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Samba, 2nd Edition by Jay Ts, Robert Eckstein, and David Collier-Brown; O'Reilly 
SAssociates 
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Dynamic Host Configuration 
Protocol (DHCP) 

Dynamic Host Configuration Protocol (DHCP) is a network protocol for automatically assigning 
TCP/IP information to client machines. Each DHCP client connects to the centrally-located 
DHCP server which returns that client's network configuration, including the IP address, 
gateway, and DNS servers. 

1. Why Use DHCP? 

DHCP is useful for automatic configuration of client network interfaces. When configuring the 
client system, the administrator can choose DHCP and instead of entering an IP address, 
netmask, gateway, or DNS servers. The client retrieves this information from the DHCP server. 
DHCP is also useful if an administrator wants to change the IP addresses of a large number of 
systems. Instead of reconfiguring all the systems, he can just edit one DHCP configuration file 
on the server for the new set of IP addresses. If the DNS servers for an organization changes, 
the changes are made on the DHCP server, not on the DHCP clients. Once the network is 
restarted on the clients (or the clients are rebooted), the changes take effect. 

Furthermore, if a laptop or any type of mobile computer is configured for DHCP, it can be moved 
from office to office without being reconfigured as long as each office has a DHCP server that 
allows it to connect to the network. 

2. Configuring a DHCP Server 

To configure a DHCP server, the /etc/dhcpd. conf configuration file must be created. A 

Sample file Can be found at /usr/share/doc/dhcp-<versio.n>/dhcpd. conf . sample. 

DHCP also uses the file /var/iib/dhcp/dhcpd. leases to store the client lease database. 
Refer to Section 2.2, "Lease Database"for more information. 

2.1. Configuration File 

The first step in configuring a DHCP server is to create the configuration file that stores the 
network information for the clients. Global options can be declared for all clients, while other 
options can be declared for individual client systems. 

The configuration file can contain extra tabs or blank lines for easier formatting. Keywords are 
case-insensitive and lines beginning with a hash mark (#) are considered comments. 

Two DNS update schemes are currently implemented — the ad-hoc DNS update mode and the 
interim DHCP-DNS interaction draft update mode. If and when these two are accepted as part 
of the Internet Engineering Task Force (IETF) standards process, there will be a third mode — 
the standard DNS update method. The DHCP server must be configured to use one of the two 
current schemes. Version 3.0b2pl1 1 and previous versions used the ad-hoc mode; however, it 
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has been deprecated. To keep the same behavior, add the following line to the top of the 
configuration file: 

ddns-update-style ad-hoc; 

To use the recommended mode, add the following line to the top of the configuration file: 

ddns-update-style interim; 

Refer to the dhopd . conf man page for details about the different modes. 
There are two types of statements in the configuration file: 



• Parameters — State how to perform a task, whether to perform a task, or what network 
configuration options to send to the client. 

• Declarations — Describe the topology of the network, describe the clients, provide addresses 
for the clients, or apply a group of parameters to a group of declarations. 

Some parameters must start with the option keyword and are referred to as options. Options 
configure DHCP options; whereas, parameters configure values that are not optional or control 
how the DHCP server behaves. 

Parameters (including options) declared before a section enclosed in curly brackets ({ }) are 
considered global parameters. Global parameters apply to all the sections below it. 



* 



Important 

If the configuration file is changed, the changes do not take effect until the DHCP 
daemon is restarted with the command service dhcpd restart. 



Instead of changing a DHCP configuration file and restarting the service each 
time, using the omsheii command provides an interactive way to connect to, 
query, and change the configuration of a DHCP server. By using omsheii, all 
changes can be made while the server is running. For more information on 
omsheii, refer to the omsheii man page. 
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In Example 23.1, "Subnet Declaration", the routers, subnet-mask, domai n-name, 
domain-name-servers, and time-offset options are used for any host statements declared 
below it. 

Additionally, a subnet can be declared, a subnet declaration must be included for every subnet 
in the network. If it is not, the DHCP server fails to start. 

In this example, there are global options for every DHCP client in the subnet and a range 
declared. Clients are assigned an IP address within the range. 



subnet 192.168.1.0 netmask 


255 .255 .255 . 


■ { 


option routers 




192.168.1.254; 


option subnet-mask 




255.255.255.0; 


option domain-name 




"example . com" ; 


option domain-name- 


-servers 


192 . 168 . 1 . 1; 


option time-offset 




-18000; # Eastern Standard Time 


range 192.168.1.10 192.168. 
} 


.1.100; 





Example 23.1. Subnet Declaration 



All subnets that share the same physical network should be declared within a shared-network 
declaration as shown in Example 23.2, "Shared-network Declaration". Parameters within the 
shared-network, but outside the enclosed subnet declarations, are considered to be global 
parameters. The name of the shared-network should be a descriptive title for the network, 
such as using the title 'test-lab' to describe all the subnets in a test lab environment. 



shared-network name { 

option domain-name "test.redhat.com"; 

option domain-name-servers nsl.redhat.com, ns2.redhat.com; 

option routers 192.168.0.254; 

more parameters for EXAMPLE shared-network 

subnet 192.168.1.0 netmask 255.255.252.0 { 

parameters for subnet 

range 192.168.1.1 192.168.1.254; 

} 

subnet 192.168.2.0 netmask 255.255.252.0 { 
parameters for subnet 
range 192.168.2.1 192.168.2.254; 

} 

} 
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Example 23.2. Shared-network Declaration 



As demonstrated in Example 23.3, "Group Declaration", the group declaration can be used to 
apply global parameters to a group of declarations. For example, shared networks, subnets, 
and hosts can be grouped. 



group { 

option routers 192.168.1.254; 
option subnet-mask 255.255.255.0; 

option domain-name "example.com"; 
option domain-name-servers 192.168.1.1; 

option time-offset -18000; # Eastern Standard Time 

host apex { 

option host-name " apex . example . com" ; 
hardware ethernet 00 : AO : 78 : 8E : 9E : AA; 
fixed-address 192.168.1.4; 



host raleigh { 

option host-name "raleigh.example.com"; 
hardware ethernet 00 : Al : DD : 74 : C3 : F2 ; 
fixed-address 192.168.1.6; 

} 

} 



Example 23.3. Group Declaration 



To configure a DHCP server that leases a dynamic IP address to a system within a subnet, 
modify Example 23.4, "Range Parameter" with your values. It declares a default lease time, 
maximum lease time, and network configuration values for the clients. This example assigns IP 
addresses in the range 192.168.1 .10 and 192.168.1.100 to client systems. 



default-lease-time 600; 
max-lease-time 7200; 
option subnet-mask 255.255.255.0; 
option broadcast-address 192.168.1.255; 
option routers 192.168.1.254; 

option domain-name-servers 192.168.1.1, 192.168.1.2; 
option domain-name "example.com"; 

subnet 192.168.1.0 netmask 255.255.255.0 { 
range 192.168.1.10 192.168.1.100; 

} 
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Example 23.4. Range Parameter 

To assign an IP address to a client based on the MAC address of the network interface card, 
use the hardware ethernet parameter within a host declaration. As demonstrated in 
Example 23.5, "Static IP Address using DHCP", the host apex declaration specifies that the 
network interface card with the MAC address 00:A0:78:8E:9E:AA always receives the IP 
address 192.168.1.4. 

Note that the optional parameter host-name can also be used to assign a host name to the 
client. 



host apex { 

option host-name "apex.example.com"; 
hardware ethernet 00 : AO : 78 : 8E : 9E : AA; 
fixed-address 192.168.1.4; 

} 

Example 23.5. Static IP Address using DHCP 



Tip 

The sample configuration file provided can be used as a starting point and 
custom configuration options can be added to it. To copy it to the proper location, 
use the following command: 

cp /usr / share /doc/dhcp-<versi on -number>/ dhcpd . conf . sample /etc/dhcpd . conf 

(where <version-number> is the DHCP version number). 



For a complete list of option statements and what they do, refer to the dhcp-options man page 

2.2. Lease Database 

On the DHCP server, the file /var/iib/dhcp/dhcpd. leases stores the DHCP client lease 
database. This file should not be modified by hand. DHCP lease information for each recently 
assigned IP address is automatically stored in the lease database. The information includes the 
length of the lease, to whom the IP address has been assigned, the start and end dates for the 
lease, and the MAC address of the network interface card that was used to retrieve the lease. 
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All times in the lease database are in Greenwich Mean Time (GMT), not local time. 

The lease database is recreated from time to time so that it is not too large. First, all known 
leases are saved in a temporary lease database. The dhcpd. leases file is renamed 

dhcpd. leases- and the temporary lease database is written to dhcpd. leases. 

The DHCP daemon could be killed or the system could crash after the lease database has been 
renamed to the backup file but before the new file has been written. If this happens, the 
dhcpd. leases file does not exist, but it is required to start the service. Do not create a new 
lease file. If you do, all old leases are lost which causes many problems. The correct solution is 
to rename the dhcpd. leases- backup file to dhcpd. leases and then start the daemon. 

2.3. Starting and Stopping the Server 



Important 

When the DHCP server is started for the first time, it fails unless the 

dhcpd. leases file exists. Use the command touch 
/var/iib/dhcp/dhcpd. leases to create the file if it does not exist. 

If the same server is also running BIND as a DNS server, this step is not 
necessary, as starting the named service automatically checks for a 

dhcpd. leases file. 



To start the DHCP service, use the command /sbin/service dhcpd start. To stop the 
DHCP server, use the command /sbin/service dhcpd stop. 

By default, the DHCP service does not start at boot time. To configure the daemon to start 
automatically at boot time, refer to Chapter 19, Controlling Access to Services tor information on 
how to manage services. 

If more than one network interface is attached to the system, but the DHCP server should only 
be started on one of the interfaces, configure the DHCP server to start only on that device. In 

/etc/sysconf ig/dhcpd, add the name of the interface to the list of dhcpdargs: 

# Command line options here 
DHCPDARGS=ethO 

This is useful for a firewall machine with two network cards. One network card can be 
configured as a DHCP client to retrieve an IP address to the Internet. The other network card 
can be used as a DHCP server for the internal network behind the firewall. Specifying only the 
network card connected to the internal network makes the system more secure because users 
can not connect to the daemon via the Internet. 

Other command line options that can be specified in /etc/sysconf ig/dhcpd include: 
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• -p <portnum> — Specify the UDP port number on which dhcpd should listen. The default is 
port 67. The DHCP server transmits responses to the DHCP clients at a port number one 
greater than the UDP port specified. For example, if the default port 67 is used, the server 
listens on port 67 for requests and responses to the client on port 68. If a port is specified 
here and the DHCP relay agent is used, the same port on which the DHCP relay agent should 
listen must be specified. Refer to Section 2.4, "DHCP Relay Agent" for details. 

• -f — Run the daemon as a foreground process. This is mostly used for debugging. 

• -d — Log the DHCP server daemon to the standard error descriptor. This is mostly used for 
debugging. If this is not specified, the log is written to /var/iog/messages. 

• -cf <fiiename> — Specify the location of the configuration file. The default location is 

/ etc/ dhcpd . conf. 

• -if <fiiename> — Specify the location of the lease database file. If a lease database file 
already exists, it is very important that the same file be used every time the DHCP server is 
started. It is strongly recommended that this option only be used for debugging purposes on 
non-production machines. The default location is /var/iib/dhcp/dhcpd. leases. 

• -q — Do not print the entire copyright message when starting the daemon. 

2.4. DHCP Relay Agent 

The DHCP Relay Agent (dhcreiay) allows for the relay of DHCP and BOOTP requests from a 
subnet with no DHCP server on it to one or more DHCP servers on other subnets. 

When a DHCP client requests information, the DHCP Relay Agent forwards the request to the 
list of DHCP servers specified when the DHCP Relay Agent is started. When a DHCP server 
returns a reply, the reply is broadcast or unicast on the network that sent the original request. 

The DHCP Relay Agent listens for DHCP requests on all interfaces unless the interfaces are 
specified in /etc/sysconf ig/dhcreiay with the interfaces directive. 

To start the DHCP Relay Agent, use the command service dhcreiay start. 

3. Configuring a DHCP Client 

The first step for configuring a DHCP client is to make sure the kernel recognizes the network 
interface card. Most cards are recognized during the installation process and the system is 
configured to use the correct kernel module for the card. If a card is added after installation, 
Kudzu 1 should recognize it and prompt for the configuration of the corresponding kernel module 
for it. Be sure to check the Hardware Compatibility List available at 

http://hardware.redhat.com/hcl/. If the network card is not configured by the installation program 
or Kudzu and you know which kernel module to load for it, refer to Chapter 37, Kernel Modules 
for details on loading kernel modules. 



1 Kudzu is a hardware probing tool run at system boot time to determine what hardware has been added or removed 
from the system. 
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To configure a DHCP client manually, modify the /etc/sysconf ig/network file to enable 
networking and the configuration file for each network device in the 
/etc/sysconf ig/network-scripts directory. In this directory, each device should have a 
configuration file named if cfg-etho, where etho is the network device name. 

The /etc/sysconf ig/network file should contain the following line: 

NETWORKING=yes 

The networking variable must be set to yes if you want networking to start at boot time. 

The /etc/sysconf ig/network-scripts/if cf g-etho file should contain the following lines: 

DEVICE=ethO 

BOOTPROTO=dhcp 

ONBOOT=yes 

A configuration file is needed for each device to be configured to use DHCP. 
Other options for the network script include: 



• dhcp_hostname — Only use this option if the DHCP server requires the client to specify a 
hostname before receiving an IP address. (The DHCP server daemon in Red Hat Enterprise 
Linux does not support this feature.) 

• PEERDNS=<answer> , where <answer> is one of the following: 

• yes — Modify /etc/resoiv.conf with information from the server. If using DHCP, then 
yes is the default. 

• no — Do not modify /etc/resolv. conf . 

• SRCADDR=<address> , where <address> is the specified source IP address for outgoing 
packets. 

• usERCTL=<answer> , where <answer> is one of the following: 

• yes — Non-root users are allowed to control this device. 

• no — Non-root users are not allowed to control this device. 

If you prefer using a graphical interface, refer to Chapter 17, Network Configuration for details 
on using the Network Administration Tool to configure a network interface to use DHCP. 
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Tip 

For advanced configurations of client DHCP options such as protocol timing, 
lease requirements and requests, dynamic DNS support, aliases, as well as a 
wide variety of values to override, prepend, or append to client-side 
configurations, refer to the dhciient and dhciient . conf man pages. 



4. Additional Resources 

For configuration options not covered here, refer to the following resources. 

4.1. Installed Documentation 

• dhcpd man page — Describes how the DHCP daemon works. 

• dhcpd . conf man page — Explains how to configure the DHCP configuration file; includes 
some examples. 

• dhcpd . leases man page — Explains how to configure the DHCP leases file; includes some 
examples. 

• dhcp-options man page — Explains the syntax for declaring DHCP options in dhcpd . conf; 
includes some examples. 

• dhcreiay man page — Explains the DHCP Relay Agent and its configuration options. 

• /usr/share/doc/dhcp-<version>/ — Contains sample files, README files, and release 
notes for the specific version of the DHCP service. 
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Apache HTTP Server Configuration 

Red Hat Enterprise Linux provides version 2.0 of the Apache HTTP Server. If you want to 
migrate an existing configuration file by hand, refer to the migration guide at 

/usr/share/doc/httpd-<ver>/migration.htmi or the Red Hat Enterprise Linux Reference 
Guide for details. 

If you configured the Apache HTTP Server with the HTTP Configuration Tool in previous 
versions of Red Hat Enterprise Linux and then performed an upgrade, you can use the HTTP 
Configuration Tool to migrate the configuration file to the new format for version 2.0. Start the 
HTTP Configuration Tool, make any changes to the configuration, and save it. The 
configuration file saved will be compatible with version 2.0. 

The httpd and system-conf ig-httpd RPM packages need to be installed to use the HTTP 
Configuration Tool. It also requires the X Window System and root access. To start the 
application, go to the Main Menu Button => System Settings => Server Settings => HTTP or 

type the command system-conf ig-httpd at a shell prompt (for example, in an XTerm or 
GNOME Terminal). 

The HTTP Configuration Tool allows you to configure the /eto/httpd/oonf /httpd. conf 
configuration file for the Apache HTTP Server. It does not use the old srm. conf or 
access . conf configuration files; leave them empty. Through the graphical interface, you can 
configure directives such as virtual hosts, logging attributes, and maximum number of 
connections. 

Only modules provided with Red Hat Enterprise Linux can be configured with the HTTP 
Configuration Tool. If additional modules are installed, they can not be configured using this 
tool. 



Caution 

Do not edit the /etc/httpd/conf /httpd. conf configuration file by hand if you 
wish to use this tool. The HTTP Configuration Tool generates this file after you 
save your changes and exit the program. If you want to add additional modules 
or configuration options that are not available in HTTP Configuration Tool, you 
cannot use this tool. 



The general steps for configuring the Apache HTTP Server using the HTTP Configuration Tool 

are as follows: 



1 . Configure the basic settings under the Main tab. 

2. Click on the Virtual Hosts tab and configure the default settings. 
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3. Under the Virtual Hosts tab, configure the Default Virtual Host. 

4. To serve more than one URL or virtual host, add any additional virtual hosts. 

5. Configure the server settings under the Server tab. 

6. Configure the connections settings under the Performance Tuning tab. 

7. Copy all necessary files to the DocumentRoot and cgi-bin directories. 

8. Exit the application and select to save your settings. 



1. Basic Settings 



Use the Main tab to configure the basic server settings. 



Main 



Virtual Hosts 



Server 



Performance Tuning 



Basic Setup 
Server Name: 

Webmaster .email address: 
Available Addresses 



root@localhost 



All available addresses on port 80 



Set addresses for Apache to listen for requests on. 



Add.., 



Edit. 



Delete 



$ OK 



£3 Cancel 



Help 



Figure 24.1. Basic Settings 



Enter a fully qualified domain name that you have the right to use in the Server Name text area. 

This Option Corresponds tO the ServerName 

[http://httpd.apache.Org/docs-2.0/mod/core.html#servername] directive in httpd.conf. The 
ServerName directive sets the hostname of the Web server. It is used when creating redirection 
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URLs. If you do not define a server name, the Web server attempts to resolve it from the IP 
address of the system. The server name does not have to be the domain name resolved from 
the IP address of the server. For example, you might set the server name to www.example.com 
while the server's real DNS name is foo.example.com. 

Enter the email address of the person who maintains the Web server in the Webmaster email 
address text area. This option corresponds to the serverAdmin 

[http://httpd.apache.Org/docs-2.0/mod/core.html#serveradmin] directive in httpd.conf. If you 
configure the server's error pages to contain an email address, this email address is used so 
that users can report a problem to the server's administrator. The default value is 
root@localhost. 

Use the Available Addresses area to define the ports on which the server accepts incoming 
requests. This option corresponds to the Listen 

[http://httpd. apache. org/docs-2.0/mod/mpm_common.html#listen] directive in httpd.conf. By 
default, Red Hat configures the Apache HTTP Server to listen to port 80 for non-secure Web 
communications. 

Click the Add button to define additional ports on which to accept requests. A window as shown 
in Figure 24.2, "Available Addresses" appears. Either choose the Listen to all addresses 
option to listen to all IP addresses on the defined port or specify a particular IP address over 
which the server accepts connections in the Address field. Only specify one IP address per port 
number. To specify more than one IP address with the same port number, create an entry for 
each IP address. If at all possible, use an IP address instead of a domain name to prevent a 
DNS lookup failure. Refer to http://httpd.apache.Org/docs-2.0/dns-caveats.htmMor more 
information about Issues Regarding DNS and Apache. 

Entering an asterisk (*) in the Address field is the same as choosing Listen to all addresses. 
Clicking the Edit button in the Available Addresses frame shows the same window as the Add 
button except with the fields populated for the selected entry. To delete an entry, select it and 
click the Delete button. 



Tip 

If you set the server to listen to a port under 1 024, you must be root to start it. 
For port 1024 and above, httpd can be started as a regular user. 
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O Listen to all addresses 
^ ® Address: 192.168.1.4] 



Port: 



SO 



$ OK 



Cancel 



Figure 24.2. Available Addresses 



2. Default Settings 



After defining the Server Name, Webmaster email address, and Available Addresses, click 
the Virtual Hosts tab and click the Edit Default Settings button. A window as shown in 
Figure 24.3, "Site Configuration" appears. Configure the default settings for your Web server in 
this window. If you add a virtual host, the settings you configure for the virtual host take 
precedence for that virtual host. For a directive not defined within the virtual host settings, the 
default value is used. 



2.1. Site Configuration 

The default values for the Directory Page Search List and Error Pages work for most servers. 
If you are unsure of these settings, do not modify them. 



258 



Site Configuration 



Page Options! 


Logging 


Environment 


Performance 





Directory Page Search List 



List of files to search for when a directory is requested. 
Eg, index. html, index, shtml etc. 

Error Pages 



Error Code 400 - Bad Request 
Default Error Page Footer 



Error Code 


Behavior 


Location 


* 


Bad Request 


default 


Authorization Required 


default 




Forbidden 


default 




Not Found 


default 




Method Not Allowed 


default 




Not Acceptable 


default 





Show footer with email address 



* Add, 



Edit, 



Delete 



^Edit, 




Figure 24.3. Site Configuration 



The entries listed in the Directory Page Search List define the Directoryindex 
[http://httpd.apache.Org/docs-2.0/mod/mod_dir.html#directoryindex] directive. The 
Directoryindex is the default page served by the server when a user requests an index of a 
directory by specifying a forward slash (/) at the end of the directory name. 

For example, when a user requests the page http: / /www. example . com/this_direotory/, 
they are going to get either the Directoryindex page, if it exists, or a server-generated 
directory list. The server tries to find one of the files listed in the Directoryindex directive and 
returns the first one it finds. If it does not find any of these files and if options indexes is set 
for that directory, the server generates and returns a list, in HTML format, of the subdirectories 
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and files in the directory. 

Use the Error Code section to configure Apache HTTP Server to redirect the client to a local or 
external URL in the event of a problem or error. This option corresponds to the ErrorDocument 
[http://httpd. apache. org/docs-2.0/mod/core.html#errordocument] directive. If a problem or error 
occurs when a client tries to connect to the Apache HTTP Server, the default action is to display 
the short error message shown in the Error Code column. To override this default configuration, 
select the error code and click the Edit button. Choose Default to display the default short error 
message. Choose URL to redirect the client to an external URL and enter a complete URL, 
including the http: //, in the Location field. Choose File to redirect the client to an internal 
URL and enter a file location under the document root for the Web server. The location must 
begin the a slash (/) and be relative to the Document Root. 

For example, to redirect a 404 Not Found error code to a webpage that you created in a file 

Called 404 .html, COpy 404 .html to DocumentRoot I . . /error/404 . html. In this Case, 

Document Root is the Document Root directory that you have defined (the default is 
/ var/www /html/). If the Document Root is left as the default location, the file should be copied 
to /var/www/error/404 .html. Then, choose File as the Behavior for 404 - Not Found error 
code and enter /error/404 .html as the Location. 

From the Default Error Page Footer menu, you can choose one of the following options: 



• Show footer with email address — Display the default footer at the bottom of all error pages 
along with the email address of the website maintainer specified by the serverAdmin 
[http://httpd.apache.Org/docs-2.0/mod/core.html#serveradmin] directive. Refer to 

Section 3. 1. 1, "General Options" tor information about configuring the ServerAdmin directive. 

• Show footer — Display just the default footer at the bottom of error pages. 

• No footer — Do not display a footer at the bottom of error pages. 

2.2. Logging 

Use the Logging tab to configure options for specific transfer and error logs. 

By default, the server writes the transfer log to the /var/iog/httpd/access_iog file and the 

error log tO the /var/log/httpd/error_log file. 

The transfer log contains a list of all attempts to access the Web server. It records the IP 
address of the client that is attempting to connect, the date and time of the attempt, and the file 
on the Web server that it is trying to retrieve. Enter the name of the path and file in which to 
store this information. If the path and file name do not start with a slash (/), the path is relative to 
the server root directory as configured. This option corresponds to the Transferiog 
[http://httpd.apache.Org/docs-2.0/mod/mod_log_config.html#transferlog] directive. 
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Page Options iLoggingi Environment Performance 



Transfer Log 

® Log to File: 

O Log to Program: 
O Use System Log: 



logs/accessjog 



□ Use custom logging facilities 
Custom Log String: 



Error Log 

® Log to File: 

O Log to Program: 
O Use System Log: 

Log Level: 

Reverse DNS Lookup: 



logs/errorjog 



Error 



Reverse Lookup 




Figure 24.4. Logging 



You can configure a custom log format by checking Use custom logging facilities and 

entering a custom log string in the Custom Log String field. This configures the LogFormat 
[http://httpd. apache. org/docs-2.0/mod/mod_log_config.html#logformat] directive. Refer to 

http://httpd.apache.Org/docs-2.0/mod/modJog_config.html#formats 

[http://httpd.apache.Org/docs-2.0/mod/mod_log_config.html#formats] for details on the format of 
this directive. 

The error log contains a list of any server errors that occur. Enter the name of the path and file 
in which to store this information. If the path and file name do not start with a slash (/), the path 
is relative to the server root directory as configured. This option corresponds to the ErrorLog 
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http://httpd.apache.Org/docs-2.0/mod/core.html#errorlog] directive. 

Use the Log Level menu to set the verbosity of the error messages in the error logs. It can be 
set (from least verbose to most verbose) to emerg, alert, crit, error, warn, notice, info or debug. 
This option corresponds to the LogLevei 

[http://httpd.apache.Org/docs-2.0/mod/core.html#loglevel] directive. 

The value chosen with the Reverse DNS Lookup menu defines the HostnameLookups 
[http://httpd.apache.Org/docs-2.0/mod/core.html#hostnamelookups] directive. Choosing No 
Reverse Lookup sets the value to off. Choosing Reverse Lookup sets the value to on. 
Choosing Double Reverse Lookup sets the value to double. 

If you choose Reverse Lookup, your server automatically resolves the IP address for each 
connection which requests a document from your Web server. Resolving the IP address means 
that your server makes one or more connections to the DNS in order to find out the hostname 
that corresponds to a particular IP address. 

If you choose Double Reverse Lookup, your server performs a double-reverse DNS. In other 
words, after a reverse lookup is performed, a forward lookup is performed on the result. At least 
one of the IP addresses in the forward lookup must match the address from the first reverse 
lookup. 

Generally, you should leave this option set to No Reverse Lookup, because the DNS requests 
add a load to your server and may slow it down. If your server is busy, the effects of trying to 
perform these reverse lookups or double reverse lookups may be quite noticeable. 

Reverse lookups and double reverse lookups are also an issue for the Internet as a whole. 
Each individual connection made to look up each hostname adds up. Therefore, for your own 
Web server's benefit, as well as for the Internet's benefit, you should leave this option set to No 
Reverse Lookup. 

2.3. Environment Variables 

Use the Environment tab to configure options for specific variables to set, pass, or unset for 
CGI scripts. 

Sometimes it is necessary to modify environment variables for CGI scripts or server-side include 
(SSI) pages. The Apache HTTP Server can use the mod_env module to configure the 
environment variables which are passed to CGI scripts and SSI pages. Use the Environment 
Variables page to configure the directives for this module. 

Use the Set for CGI Scripts section to set an environment variable that is passed to CGI scripts 
and SSI pages. For example, to set the environment variable maximum to 50, click the Add button 
inside the Set for CGI Script section, as shown in Figure 24.5, "Environment Variables", and 
type maxnum in the Environment Variable text field and 50 in the Value to set text field. Click 
OK to add it to the list. The Set for CGI Scripts section configures the setEnv 
[http://httpd.apache.0rg/docs-2.O/mod/mod_env.html#setenv] directive. 

Use the Pass to CGI Scripts section to pass the value of an environment variable when the 



262 



Environment Variables 



server is first started to CGI scripts. To see this environment variable, type the command env at 
a shell prompt. Click the Add button inside the Pass to CGI Scripts section and enter the name 
of the environment variable in the resulting dialog box. Click OK to add it to the list. The Pass to 
CGI Scripts section configures the Pa ssEnv 

[http://httpd. apache. org/docs-2.0/mod/mod_env.html#passenv] directive. 



Page Options Logging \ Environment! Performance 



Set for CGI Scripts 



Environment Variable 



Value 



Pass to CGI Scripts 



Unset for CGI Scripts 





* Add... 




J* Edit... 


fll Delete 



Add. 



Edit... 



Delete 



Add... 



Edit... 



Delete 




Figure 24.5. Environment Variables 



To remove an environment variable so that the value is not passed to CGI scripts and SSI 
pages, use the Unset for CGI Scripts section. Click Add in the Unset for CGI Scripts section, 
and enter the name of the environment variable to unset. Click OK to add it to the list. This 
corresponds to the UnsetEnv [http://httpd. apache. org/docs-2.0/mod/mod_env.html#unsetenv] 
directive. 
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To edit any of these environment values, select it from the list and click the corresponding Edit 
button. To delete any entry from the list, select it and click the corresponding Delete button. 

To learn more about environment variables in the Apache HTTP Server, refer to the following: 

http: //httpd. apache . org/docs-2 . 0/env . html 



2.4. Directories 

Use the Directories page in the Performance tab to configure options for specific directories. 
This corresponds to the <Directory> 

[http://httpd.apache.Org/docs-2.0/mod/core.html#directory] directive. 



Page Options Logging Environment performance 



Default Directory Options: 

ExecCGI, FollowSymLinks, Includes, IncludesNOEXEC 
Indexes, SymLinkslfOwnerMatch 

Directory 



^Edit. 



* Add... 
^Edit... 
© Delete 
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Figure 24.6. Directories 

Click the Edit button in the top right-hand corner to configure the Default Directory Options for 
all directories that are not specified in the Directory list below it. The options that you choose 
are listed as the options [http://httpd.apache.Org/docs-2.0/mod/core.html#options] directive 
within the <Directory> [http://httpd.apache.org/docs-2.0/mod/core.html#directory] directive. 
You can configure the following options: 

• ExecCGI — Allow execution of CGI scripts. CGI scripts are not executed if this option is not 
chosen. 

• FollowSymLinks — Allow symbolic links to be followed. 

• Includes — Allow server-side includes. 

• IncludesNOEXEC — Allow server-side includes, but disable the texec and #inciude 
commands in CGI scripts. 

• Indexes — Display a formatted list of the directory's contents, if no Directoryindex (such as 
index.htmi) exists in the requested directory. 

• Multiview — Support content-negotiated multiviews; this option is disabled by default. 

• SymLinkslfOwnerMatch — Only follow symbolic links if the target file or directory has the 
same owner as the link. 

To specify options for specific directories, click the Add button beside the Directory list box. A 
window as shown in Figure 24.7, "Directory Settings" appears. Enter the directory to configure in 
the Directory text field at the bottom of the window. Select the options in the right-hand list and 
configure the order [http://httpd.apache.Org/docs-2.0/mod/mod_access.html#order] directive 
with the left-hand side options. The order directive controls the order in which allow and deny 
directives are evaluated. In the Allow hosts from and Deny hosts from text field, you can 
specify one of the following: 



• Allow all hosts — Type ail to allow access to all hosts. 

• Partial domain name — Allow all hosts whose names match or end with the specified string. 

• Full IP address — Allow access to a specific IP address. 

• A subnet — Such as 192. 168. 1.0/255. 255. 255.0 

• A network CIDR specification — such as 10 . 3 . . 0/16 
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Order 

O Let all hosts access this directory 
O Process Deny list before Allow list 
® Process Allow list before Deny list 



Deny List 

® Deny access from all hosts 
O Deny hosts from: 



Allow List 

O Allow access from all hosts 



® Allow hosts from: 192.168.1. 0/255. 255. 255. o| 



Options 



Options 



S ExecCGI 



FollowSymLinks 

Includes 

IncludesNQEXEC 

Indexes 

□ MultiViews 

SymLinkslfOwnerMatch 



□ Let .htaccess files override directory options 



Directory: 



/v ar/www/htm l/t e st i n g 




Figure 24.7. Directory Settings 



If you check the Let .htaccess files override directory options, the configuration directives in 
the .htaccess file take precedence. 

3. Virtual Hosts Settings 

Virtual hosts allow you to run different servers for different IP addresses, different host names, 
or different ports on the same machine. For example, you can run the website for 
http://www.example.com and http://www.anotherexample.com on the same Web server using 
virtual hosts. This option corresponds to the <VirtualHost> 

[http://httpd.apache.Org/docs-2.0/mod/core.html#virtualhost] directive for the default virtual host 
and IP based virtual hosts. It corresponds to the <NamevirtuaiHost> 
[http://httpd.apache.Org/docs-2.0/mod/core.html#namevirtualhost] directive for a name based 
virtual host. 

The directives set for a virtual host only apply to that particular virtual host. If a directive is set 
server-wide using the Edit Default Settings button and not defined within the virtual host 
settings, the default setting is used. For example, you can define a Webmaster email address 
in the Main tab and not define individual email addresses for each virtual host. 

The HTTP Configuration Tool includes a default virtual host as shown in Figure 24.8, "Virtual 
Hosts". 
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Main 



Virtual Hosts 



Server 



Performance Tuning 



Virtual Hosts 



Name 



Address 



Add. 



Default Virtual Host Default virtual host 



Edit. 



Delete 



Edit Default Settings. 



^ OK 



>3 Cancel 



©Help 



Figure 24.8. Virtual Hosts 



http://httpd.apache.org/docs-2.0/vhosts/ and the Apache HTTP Server documentation on your 
machine provide more information about virtual hosts. 

3.1. Adding and Editing a Virtual Host 

To add a virtual host, click the Virtual Hosts tab and then click the Add button. You can also 
edit a virtual host by selecting it and clicking the Edit button. 



3.1.1. General Options 

The General Options settings only apply to the virtual host that you are configuring. Set the 
name of the virtual host in the Virtual Host Name text area. This name is used by HTTP 
Configuration Tool to distinguish between virtual hosts. 

Set the Document Root Directory value to the directory that contains the root document (such 
as index.html) for the virtual host. This option corresponds to the Document Root 
[http://httpd.apache.org/docs-2.0/mod/core.html#documentroot] directive within the 
<virtuaiHost> [http://httpd.apache.org/docs-2.0/mod/core.html#virtualhost] directive. The 

default DocumentRoot is /var/www/html. 
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The Webmaster email address corresponds to the serverAdmin 

[http://httpd.apache.Org/docs-2.0/mod/core.html#serveradmin] directive within the virtuaiHost 
[http://httpd.apache.Org/docs-2.0/mod/core.html#virtualhost] directive. This email address is 
used in the footer of error pages if you choose to show a footer with an email address on the 
error pages. 

In the Host Information section, choose Default Virtual Host, IP based Virtual Host, or 
Name based Virtual Host. 



Default Virtual Host 

You should only configure one default virtual host (remember that there is one setup by 
default). The default virtual host settings are used when the requested IP address is not 
explicitly listed in another virtual host. If there is no default virtual host defined, the main 
server settings are used. 

IP based Virtual Host 

If you choose IP based Virtual Host, a window appears to configure the <VirtualHost> 
[http://httpd.apache.Org/docs-2.0/mod/core.html#virtualhost] directive based on the IP 
address of the server. Specify this IP address in the IP address field. To specify multiple IP 
addresses, separate each IP address with spaces. To specify a port, use the syntax ip 
Address : Port. Use "colon, asterisk" (: *) to configure all ports for the IP address. Specify 
the host name for the virtual host in the Server Host Name field. 

Name based Virtual Host 

If you choose Name based Virtual Host, a window appears to configure the 
NamevirtuaiHost [http://httpd.apache.org/docs-2.0/mod/core.html#namevirtualhost] 
directive based on the host name of the server. Specify the IP address in the IP address 
field. To specify multiple IP addresses, separate each IP address with spaces. To specify a 
port, use the syntax ip Address:Port. Use "colon, asterisk" (: *) to configure all ports for 
the IP address. Specify the host name for the virtual host in the Server Host Name field. In 
the Aliases section, click Add to add a host name alias. Adding an alias here adds a 
ServerAiias [http://httpd.apache.org/docs-2.0/mod/core.html#serveralias] directive within 
the NamevirtuaiHost [http://httpd.apache.org/docs-2.0/mod/core.html#namevirtualhost] 
directive. 

3.1.2. SSL 




Note 

You cannot use name based virtual hosts with SSL because the SSL handshake 
(when the browser accepts the secure Web server's certificate) occurs before the 
HTTP request, which identifies the appropriate name based virtual host. If you 
plan to use name-based virtual hosts, remember that they only work with your 
non-secure Web server. 
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General Options Page Options SSL Logging Environment Performance 



0iEnable SSL support 



SSL Configuration 

Certificate File: 

Certificate Key File: 
Certificate Chain File: 



/et c/htt pd/c o nf/s s I , c rt/s erv er, c rt 



/etc/httpd/conf/ssl, key/server, key 



/et c/htt pd/conf/ssl, crt/ca, crt 



Certificate Authority File: /etc/httpd/conf/ssl, crt/ca-bundle, crt 



SSL Options 



D FakeBasicAuth 
D ExportCertData 
D CompatEnvVars 
D StrictRequire 
D OptRenegotiate 




Figure 24.9. SSL Support 



If an Apache HTTP Server is not configured with SSL support, communications between an 
Apache HTTP Server and its clients are not encrypted. This is appropriate for websites without 
personal or confidential information. For example, an open source website that distributes open 
source software and documentation has no need for secure communications. However, an 
ecommerce website that requires credit card information should use the Apache SSL support to 
encrypt its communications. Enabling Apache SSL support enables the use of the mod_ssi 
security module. To enable it through the HTTP Configuration Tool, you must allow access 
through port 443 under the Main tab => Available Addresses. Refer to Section 1, "Basic 
Settings" for details. Then, select the virtual host name in the Virtual Hosts tab, click the Edit 
button, choose SSL from the left-hand menu, and check the Enable SSL Support option as 
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shown in Figure 24.9, "SSL Support". The SSL Configuration section is pre-configured with the 
dummy digital certificate. The digital certificate provides authentication for your secure Web 
server and identifies the secure server to client Web browsers. You must purchase your own 
digital certificate. Do not use the dummy one provided for your website. For details on 
purchasing a CA-approved digital certificate, refer to the Chapter 25, Apache HTTP Secure 
Server Configuration. 

3.1.3. Additional Virtual Host Options 

The Site Configuration, Environment Variables, and Directories options for the virtual hosts 
are the same directives that you set when you clicked the Edit Default Settings button, except 
the options set here are for the individual virtual hosts that you are configuring. Refer to 
Section 2, "Default Settings" for details on these options. 



4. Server Settings 



The Server tab allows you to configure basic server settings. The default settings for these 
options are appropriate for most situations. 



Main Virtual Hosts Server Performance Tuning 
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Figure 24.10. Server Configuration 



The Lock File value corresponds to the LockFUe 
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http://httpd.apache.Org/docs-2.0/mod/mpm_common.html#lockfile] directive. This directive sets 
the path to the lockfile used when the server is compiled with either 
USE FCNTL SERIALIZED ACCEPT or USE_FLOCK_SERIALIZED_ACCEPT. It must be 
stored on the local disk. It should be left to the default value unless the logs directory is located 
on an NFS share. If this is the case, the default value should be changed to a location on the 
local disk and to a directory that is readable only by root. 

The PID File value corresponds to the pidFUe 

[http://httpd.apache.Org/docs-2.0/mod/mpm_common.html#pidfile] directive. This directive sets 
the file in which the server records its process ID (pid). This file should only be readable by root. 
In most cases, it should be left to the default value. 

The Core Dump Directory value corresponds to the coreDumpDirectory 
[http://httpd.apache.Org/docs-2.0/mod/mpm_common.html#coredumpdirectory] directive. The 
Apache HTTP Server tries to switch to this directory before executing a core dump. The default 
value is the serverRoot. However, if the user that the server runs as can not write to this 
directory, the core dump can not be written. Change this value to a directory writable by the user 
the server runs as, if you want to write the core dumps to disk for debugging purposes. 

The User value corresponds to the User 

[http://httpd. apache. org/docs-2.0/mod/mpm_common.html#user] directive. It sets the userid 
used by the server to answer requests. This user's settings determine the server's access. Any 
files inaccessible to this user are also inaccessible to your website's visitors. The default for 
user is apache. 

The user should only have privileges so that it can access files which are supposed to be visible 
to the outside world. The user is also the owner of any CGI processes spawned by the server. 
The user should not be allowed to execute any code which is not intended to be in response to 
HTTP requests. 



A 



Warning 

Unless you know exactly what you are doing, do not set the user directive to 
root. Using root as the user creates large security holes for your Web server. 



The parent httpd process first runs as root during normal operations, but is then immediately 
handed off to the apache user. The server must start as root because it needs to bind to a port 
below 1024. Ports below 1024 are reserved for system use, so they can not be used by anyone 
but root. Once the server has attached itself to its port, however, it hands the process off to the 
apache user before it accepts any connection requests. 

The Group value corresponds to the Group 

[http://httpd.apache.Org/docs-2.0/mod/mpm_common.html#group] directive. The Group directive 
is similar to the user directive. Group sets the group under which the server answers requests. 
The default group is also apache. 
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5. Performance Tuning 



Click on the Performance Tuning tab to configure the maximum number of child server 
processes you want and to configure the Apache HTTP Server options for client connections. 
The default settings for these options are appropriate for most situations. Altering these settings 
may affect the overall performance of your Web server. 



Main 



Virtual Hosts 



Server 



Performance Tuning 



Servers 



Max Number of Connections: 150 

— I 



Connections 



300 



Connection Timeout: 
O Allow unlimited requests per connection 
® Max requests per connection: 



100 



Requests per Connection 

D Allow Persistent Connections 

Timeout for next Connection: 15 



1 



^ OK 



^ Cancel 



©Help 



Figure 24.11. Performance Tuning 



Set Max Number of Connections to the maximum number of simultaneous client requests that 
the server can handle. For each connection, a child httpd process is created. After this 
maximum number of processes is reached, no one else can connect to the Web server until a 
child server process is freed. You can not set this value to higher than 256 without recompiling. 
This option corresponds to the Maxciients 

[http://httpd.apache.Org/docs-2.0/mod/mpm_common.html#maxclients] directive. 

Connection Timeout defines, in seconds, the amount of time that your server waits for receipts 
and transmissions during communications. Specifically, Connection Timeout defines how long 
your server waits to receive a GET request, how long it waits to receive TCP packets on a 
POST or PUT request, and how long it waits between ACKs responding to TCP packets. By 
default, Connection Timeout is set to 300 seconds, which is appropriate for most situations. 
This option corresponds to the Timeout 
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http://httpd.apache.Org/docs-2.0/mod/core.html#timeout] directive. 

Set the Max requests per connection to the maximum number of requests allowed per 
persistent connection. The default value is 1 00, which should be appropriate for most situations. 

This Option Corresponds tO the MaxRequestsPerChild 

[http://httpd.apache.Org/docs-2.0/mod/mpm_common.html#maxrequestsperchild] directive. 
If you check the Allow unlimited requests per connection option, the 

MaxKeepAli veRequests 

[http://httpd. apache. org/docs-2.0/mod/core.html#maxkeepaliverequests] directive is set to and 
unlimited requests are allowed. 

If you uncheck the Allow Persistent Connections option, the KeepAiive 
[http://httpd.apache.Org/docs-2.0/mod/core.html#keepalive] directive is set to false. If you check 
it, the KeepAiive [http://httpd.apache.org/docs-2.0/mod/core.html#keepalive] directive is set to 

true, and the KeepAliveTimeout 

[http://httpd.apache.Org/docs-2.0/mod/core.html#keepalivetimeout] directive is set to the number 
that is selected as the Timeout for next Connection value. This directive sets the number of 
seconds your server waits for a subsequent request, after a request has been served, before it 
closes the connection. Once a request has been received, the Connection Timeout value 
applies instead. 

Setting the Persistent Connections to a high value may cause the server to slow down, 
depending on how many users are trying to connect to it. The higher the number, the more 
server processes are waiting for another connection from the last client that connected to it. 

6. Saving Your Settings 

If you do not want to save your Apache HTTP Server configuration settings, click the Cancel 
button in the bottom right corner of the HTTP Configuration Tool window. You are prompted to 
confirm this decision. If you click Yes to confirm this choice, your settings are not saved. 

If you want to save your Apache HTTP Server configuration settings, click the OK button in the 
bottom right corner of the HTTP Configuration Tool window. A dialog window appears. If you 
answer Yes, your settings are saved in /etc/httpd/conf /httpd . conf . Remember that your 
original configuration file is overwritten with your new settings. 

If this is the first time that you have used the HTTP Configuration Tool, a dialog window 
appears, warning you that the configuration file has been manually modified. If the HTTP 
Configuration Tool detects that the httpd. conf configuration file has been manually modified, 
it saves the manually modified file as /etc/httpd/conf/httpd.conf .bak. 



Important 

After saving your settings, you must restart the httpd daemon with the command 
service httpd restart. You must be logged in as root to execute this 
command. 
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7. Additional Resources 

To learn more about the Apache HTTP Server, refer to the following resources. 

7.1. Installed Documentation 

• /usr/share/docs/httpd-<version>/migration.html — The Apache Migration HOWTO 

document contains a list of changes from version 1 .3 to version 2.0 as well as information 
about how to migration the configuration file manually. 

7.2. Useful Websites 

• http://www.apache.org/ — The Apache Software Foundation. 

• http://httpd.apache.Org/docs-2.0/ — The Apache Software Foundation's documentation on 
Apache HTTP Server version 2.0, including the Apache HTTP Server Version 2.0 User's 
Guide. 

• http://www.redhat.com/support/resources/web_ftp/apache.html — Red Hat Support maintains 
a list of useful Apache HTTP Server links. 

• http://www.redhat.com/support/docs/faqs/RH-apache-FAQ/book1.html — The Apache 
Centralized Knowledgebase compiled by Red Hat. 

7.3. Related Books 



• Apache: The Definitive Guide by Ben Laurie and Peter Laurie; O'Reilly & Associates, Inc. 

• Red Hat Enterprise Linux Reference Guide ; Red Hat, Inc. — This companion manual 
includes instructions for migrating from Apache HTTP Server version 1 .3 to Apache HTTP 
Server version 2.0 manually, more details about the Apache HTTP Server directives, and 
instructions for adding modules to the Apache HTTP Server. 
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Apache HTTP Secure Server 
Configuration 

1. Introduction 

This chapter provides basic information on the Apache HTTP Server with the mod_ssi security 
module enabled to use the OpenSSL library and toolkit. The combination of these three 
components are referred to in this chapter as the secure Web server or just as the secure 
server. 

The mod_ssi module is a security module for the Apache HTTP Server. The mod_ssi module 
uses the tools provided by the OpenSSL Project to add a very important feature to the Apache 
HTTP Server — the ability to encrypt communications. In contrast, regular HTTP 
communications between a browser and a Web server are sent in plain text, which could be 
intercepted and read by someone along the route between the browser and the server. 

This chapter is not meant to be complete and exclusive documentation for any of these 
programs. When possible, this guide points to appropriate places where you can find more 
in-depth documentation on particular subjects. 

This chapter shows you how to install these programs. You can also learn the steps necessary 
to generate a private key and a certificate request, how to generate your own self-signed 
certificate, and how to install a certificate to use with your secure server. 

The mod_ssi configuration file is located at /etc/httpd/conf . d/ssi . conf . For this file to be 
loaded, and hence formod_ssi to work, you must have the statement include conf .d/*.oonf 
in the /etc/httpd/conf /httpd . conf file. This statement is included by default in the default 
Apache HTTP Server configuration file. 

2. An Overview of Security-Related Packages 

To enable the secure server, you must have the following packages installed at a minimum: 



httpd 

The httpd package contains the httpd daemon and related utilities, configuration files, 
icons, Apache HTTP Server modules, man pages, and other files used by the Apache 
HTTP Server. 

mod_s s 1 

The mod_ssi package includes the mod_ssi module, which provides strong cryptography 
for the Apache HTTP Server via the Secure Sockets Layer (SSL) and Transport Layer 
Security (TLS) protocols. 

openssl 
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The openssi package contains the OpenSSL toolkit. The OpenSSL toolkit implements the 
SSL and TLS protocols, and also includes a general purpose cryptography library. 

Additionally, other software packages provide certain security functionalities (but are not 
required by the secure server to function): 



httpd-devel 

The httpd-devei package contains the Apache HTTP Server include files, header files, 
and the APXS utility. You need all of these if you intend to load any extra modules, other 
than the modules provided with this product. Refer to the Red Hat Enterprise Linux 
Reference Gu/'cfe for more information on loading modules onto your secure server using 
Apache's dynamic shared object (DSO) functionality. 

If you do not intend to load other modules onto your Apache HTTP Server, you do not need 
to install this package. 

OpenSSH packages 

The OpenSSH packages provide the OpenSSH set of network connectivity tools for logging 
into and executing commands on a remote machine. OpenSSH tools encrypt all traffic 
(including passwords), so you can avoid eavesdropping, connection hijacking, and other 
attacks on the communications between your machine and the remote machine. 

The openssh package includes core files needed by both the OpenSSH client programs 
and the OpenSSH server. The openssh package also contains scp, a secure replacement 
for rep (for securely copying files between machines). 

The openssh-askpass package supports the display of a dialog window which prompts for 
a password during use of the OpenSSH agent. 

The openssh-askpass-gnome package can be used in conjunction with the GNOME 
desktop environment to display a graphical dialog window when OpenSSH programs 
prompt for a password. If you are running GNOME and using OpenSSH utilities, you should 
install this package. 

The openssh-server package contains the sshd secure shell daemon and related files. 
The secure shell daemon is the server side of the OpenSSH suite and must be installed on 
your host to allow SSH clients to connect to your host. 

The openssh-oiients package contains the client programs needed to make encrypted 
connections to SSH servers, including the following: ssh, a secure replacement for rsh; 
sftp, a secure replacement for ftp (for transferring files between machines); and siogin, a 
secure replacement for riogin (for remote login) and telnet (for communicating with 
another host via the Telnet protocol). 

For more information about OpenSSH, see Chapter 20, OpenSSH, the Red Hat Enterprise 
Linux Reference Guide, and the OpenSSH website at http://www.openssh.com/ 
[http://www.openssh.com]. 
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opens si -de vel 

The openssi-devei package contains the static libraries and the include file needed to 
compile applications with support for various cryptographic algorithms and protocols. You 
need to install this package only if you are developing applications which include SSL 
support — you do not need this package to use SSL. 

stunnel 

The stunnel package provides the Stunnel SSL wrapper. Stunnel supports the SSL 
encryption of TCP connections. It provides encryption for non-SSL aware daemons and 
protocols (such as POP, IMAP, and LDAP) without requiring any changes to the daemon's 
code. 




Note 

Newer implementations of various daemons now provide their services natively 
over SSL, such as dovecot or OpenLDAP's siapd server, which may be more 
desirable than using stunnel. 

For example, use of stunnel only provides wrapping of protocols, while the 
native support in OpenLDAP's siapd can also handle in-band upgrades for using 
encryption in response to a startTLS client request. 



Table 25. 1, "Security Packages" displays a summary of the secure server packages and 
whether each package is optional for the installation of a secure server. 



Package Name 


Optional? 


httpd 


no 


mod_ssl 


no 


openssl 


no 


httpd-devel 


yes 


openssh 


yes 


opens sh-askpass 


yes 


opens sh-askpass -gnome 


yes 


opens sh-clients 


yes 


openssh- server 


yes 


opens si -de vel 


yes 


stunnel 


yes 



Table 25.1. Security Packages 
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3. An Overview of Certificates and Security 

Your secure server provides security using a combination of the Secure Sockets Layer (SSL) 
protocol and (in most cases) a digital certificate from a Certificate Authority (CA). SSL handles 
the encrypted communications as well as the mutual authentication between browsers and your 
secure server. The CA-approved digital certificate provides authentication for your secure server 
(the CA puts its reputation behind its certification of your organization's identity). When your 
browser is communicating using SSL encryption, the https : // prefix is used at the beginning of 
the Uniform Resource Locator (URL) in the navigation bar. 

Encryption depends upon the use of keys (think of them as secret encoder/decoder rings in 
data format). In conventional or symmetric cryptography, both ends of the transaction have the 
same key, which they use to decode each other's transmissions. In public or asymmetric 
cryptography, two keys co-exist: a public key and a private key. A person or an organization 
keeps their private key a secret and publishes their public key. Data encoded with the public key 
can only be decoded with the private key; data encoded with the private key can only be 
decoded with the public key. 

To set up your secure server, use public cryptography to create a public and private key pair. In 
most cases, you send your certificate request (including your public key), proof of your 
company's identity, and payment to a CA. The CA verifies the certificate request and your 
identity, and then sends back a certificate for your secure server. 

A secure server uses a certificate to identify itself to Web browsers. You can generate your own 
certificate (called a "self-signed" certificate), or you can get a certificate from a CA. A certificate 
from a reputable CA guarantees that a website is associated with a particular company or 
organization. 

Alternatively, you can create your own self-signed certificate. Note, however, that self-signed 
certificates should not be used in most production environments. Self-signed certificates are not 
automatically accepted by a user's browser — users are prompted by the browser to accept the 
certificate and create the secure connection. Refer to Section 5, "Types of Certificates" \or more 
information on the differences between self-signed and CA-signed certificates. 

Once you have a self-signed certificate or a signed certificate from the CA of your choice, you 
must install it on your secure server. 

4. Using Pre-Existing Keys and Certificates 

If you already have an existing key and certificate (for example, if you are installing the secure 
server to replace another company's secure server product), you can probably use your existing 
key and certificate with the secure server. The following two situations provide instances where 
you are not able to use your existing key and certificate: 



• If you are changing your IP address or domain name — Certificates are issued for a particular 
IP address and domain name pair. You must get a new certificate if you are changing your IP 
address or domain name. 
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If you have a certificate from VeriSign and you are changing your server software — VeriSign 
is a widely used CA. If you already have a VeriSign certificate for another purpose, you may 
have been considering using your existing VeriSign certificate with your new secure server. 
However, you are not be allowed to because VeriSign issues certificates for one specific 
server software and IP address/domain name combination. 

If you change either of those parameters (for example, if you previously used a different 
secure server product), the VeriSign certificate you obtained to use with the previous 
configuration will not work with the new configuration. You must obtain a new certificate. 

If you have an existing key and certificate that you can use, you do not have to generate a new 
key and obtain a new certificate. However, you may need to move and rename the files which 
contain your key and certificate. 

Move your existing key file to: 

/etc/httpd/conf / ssl . key/ server .key 

Move your existing certificate file to: 

/etc/httpd/conf/ ssl . crt/ server . crt 

After you have moved your key and certificate, skip to Section 9, "Testing The Certificate". 

If you are upgrading from the Red Hat Secure Web Server, your old key (httpsd . key) and 
certificate (httpsd. crt) are located in /etc/httpd/conf/. Move and rename your key and 
certificate so that the secure server can use them. Use the following two commands to move 
and rename your key and certificate files: 

mv /etc/httpd/conf /httpsd. key /etc/httpd/conf /ssl . key/server . key mv 
/etc/httpd/conf /httpsd .crt /etc/httpd/conf/ssl.crt /server . crt 

Then, start your secure server with the command: 

/sbin/service httpd start 

You are prompted to enter your passphrase. After you type it in and press Enter, the server 
starts. 

5. Types of Certificates 

If you installed your secure server from the RPM package provided by Red Hat, a random key 
and a test certificate are generated and put into the appropriate directories. Before you begin 
using your secure server, however, you must generate your own key and obtain a certificate 
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which correctly identifies your server. 

You need a key and a certificate to operate your secure server — which means that you can 
either generate a self-signed certificate or purchase a CA-signed certificate from a CA. What are 
the differences between the two? 

A CA-signed certificate provides two important capabilities for your server: 

• Browsers (usually) automatically recognize the certificate and allow a secure connection to be 
made, without prompting the user. 

• When a CA issues a signed certificate, they are guaranteeing the identity of the organization 
that is providing the webpages to the browser. 

If your secure server is being accessed by the public at large, your secure server needs a 
certificate signed by a CA so that people who visit your website know that the website is owned 
by the organization who claims to own it. Before signing a certificate, a CA verifies that the 
organization requesting the certificate was actually who they claimed to be. 

Most Web browsers that support SSL have a list of CAs whose certificates they automatically 
accept. If a browser encounters a certificate whose authorizing CA is not in the list, the browser 
asks the user to either accept or decline the connection. 

You can generate a self-signed certificate for your secure server, but be aware that a 
self-signed certificate does not provide the same functionality as a CA-signed certificate. A 
self-signed certificate is not automatically recognized by most Web browsers and does not 
provide any guarantee concerning the identity of the organization that is providing the website. 
A CA-signed certificate provides both of these important capabilities for a secure server. If your 
secure server is to be used in a production environment, a CA-signed certificate is 
recommended. 

The process of getting a certificate from a CA is fairly easy. A quick overview is as follows: 

1 . Create an encryption private and public key pair. 

2. Create a certificate request based on the public key. The certificate request contains 
information about your server and the company hosting it. 

3. Send the certificate request, along with documents proving your identity, to a CA. Red Hat 
does not make recommendations on which certificate authority to choose. Your decision may 
be based on your past experiences, on the experiences of your friends or colleagues, or 
purely on monetary factors. 

Once you have decided upon a CA, you need to follow the instructions they provide on how 
to obtain a certificate from them. 

4. When the CA is satisfied that you are indeed who you claim to be, they provide you with a 
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digital certificate. 

5. Install this certificate on your secure server and begin handling secure transactions. 

Whether you are getting a certificate from a CA or generating your own self-signed certificate, 
the first step is to generate a key. Refer to Section 6, "Generating a Key" for instructions. 

6. Generating a Key 

You must be root to generate a key. 

First, use the cd command to change to the /etc/httpd/conf / directory. Remove the fake key 
and certificate that were generated during the installation with the following commands: 

rm ssl . key/server . keyrm ssl . crt/server . crt 

Next, create your own random key. Change to the /usr/share/ssi/certs/ directory and type 
in the following command: 

make genkey 



Your system displays a message similar to the following: 



umask 7 7 ; \ 






/usr/bin/openssl genrsa -des3 1024 > 


/etc/httpd/conf/ssl. 


, key/ server . key 


Generating RSA private key, 1024 bit 


long modulus 




++++++ 




++++++ 


e is 65537 (0x10001) 






Enter pass phrase: 







You now must enter in a passphrase. For security reason, it should contain at least eight 
characters, include numbers and/or punctuation, and it should not be a word in a dictionary. 
Also, remember that your passphrase is case sensitive. 



Note 

You are required to remember and enter this passphrase every time you start 
your secure server. If you forget this passphrase, the key must be completely 
re-generated. 



Re-type the passphrase to verify that it is correct. Once you have typed it in correctly, 

/etc/httpd/conf/ssi . key/server . key, the file containing your key, is created. 
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Note that if you do not want to type in a passphrase every time you start your secure server, 
you must use the following two commands instead of make gen key to create the key. 

Use the following command to create your key: 

/usr/bin/openssl genrsa 1024 > /etc/httpd/conf /ssl . key/server . key 



Then, use the following command to make sure the permissions are set correctly for the file: 

chmod go-rwx /etc/httpd/conf /ssl . key/server . key 

After you use the above commands to create your key, you do not need to use a passphrase to 
start your secure server. 



Caution 

Disabling the passphrase feature for your secure server is a security risk. It is not 
recommended that you disable the passphrase feature for secure server. 



Problems associated with not using a passphrase are directly related to the security maintained 
on the host machine. For example, if an unscrupulous individual compromises the regular UNIX 
security on the host machine, that person could obtain your private key (the contents of your 
server . key file). The key could be used to serve webpages that appear to be from your secure 
server. 

If UNIX security practices are rigorously maintained on the host computer (all operating system 
patches and updates are installed as soon as they are available, no unnecessary or risky 
services are operating, and so on), secure server's passphrase may seem unnecessary. 
However, since your secure server should not need to be re-booted very often, the extra 
security provided by entering a passphrase is a worthwhile effort in most cases. 

The server . key file should be owned by the root user on your system and should not be 
accessible to any other user. Make a backup copy of this file and keep the backup copy in a 
safe, secure place. You need the backup copy because if you ever lose the server .key file 
after using it to create your certificate request, your certificate no longer works and the CA is not 
able to help you. Your only option is to request (and pay for) a new certificate. 

If you are going to purchase a certificate from a CA, continue to Section 7, "Generating a 
Certificate Request to Send to a CA". If you are generating your own self-signed certificate, 
continue to Section 8, "Creating a Self-Signed Certificate". 

7. Generating a Certificate Request to Send to a CA 

Once you have created a key, the next step is to generate a certificate request which you need 
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to send to the CA of your choice. Make sure you are in the /usr/share/ssi/certs/ directory, 
and type the following command: 

make certreq 

Your system displays the following output and asks you for your passphrase (unless you 
disabled the passphrase option): 

umask 7 7 ; \ 

/usr/bin/openssl req -new -key /etc/httpd/conf /ssl . key/server . key 

-out /etc/httpd/conf/ssl. csr/ server . csr 

Using configuration from /usr/share/ssl/openssl . cnf 

Enter pass phrase: 

Type in the passphrase that you chose when you were generating your key unless you don't 
need to. Next, your system displays some instructions and then ask for a series of responses 
from you. Your inputs are incorporated into the certificate request. The display, with example 
responses, looks similar to the following: 

You are about to be asked to enter information that will be incorporated 
into your certificate request. 

What you are about to enter is what is called a Distinguished Name or a 
DN. 

There are quite a few fields but you can leave some blank 
For some fields there will be a default value, 
If you enter ' . ', the field will be left blank. 



Country Name (2 letter code) [GB] :USState or Province Name (full name) 
[Berkshire] :North CarolinaLocality Name (eg, city) 

[Newbury] :RaleighOrganization Name (eg, company) [My Company Ltd] :Test 
CompanyOrganizational Unit Name (eg, section) [] : TestingCommon Name (your 
name or server's hostname) [] : test . example . comEmail Address 

[ ] : admin@example . comPlease enter the following 'extra' attributes 
to be sent with your certificate request 
A challenge password [] : 
An optional company name [] : 

The default answers appear in brackets ( [ ] ) immediately after each request for input. For 
example, the first information required is the name of the country where the certificate is to be 
used, shown like the following: 

Country Name (2 letter code) [GB] : 

The default input, in brackets, is gb. Accept the default by pressing Enter or fill in your country's 
two letter code. 
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You have to type in the rest of the values. All of these should be self-explanatory, but you must 
follow these guidelines: 

• Do not abbreviate the locality or state. Write them out (for example, St. Louis should be 
written out as Saint Louis). 

• If you are sending this CSR to a CA, be very careful to provide correct information for all of 
the fields, but especially for the organization Name and the common Name. CAs check the 
information provided in the CSR to determine whether your organization is responsible for 
what you provided as the Common Name. CAs rejects CSRs which include information they 
perceive as invalid. 

• For common Name, make sure you type in the real name of your secure server (a valid DNS 
name) and not any aliases which the server may have. 

• The Email Address should be the email address for the webmaster or system administrator. 

• Avoid special characters like @, #, & !, and etc. Some CAs reject a certificate request which 
contains a special character. If your company name includes an ampersand (&), spell it out as 
"and" instead of "&." 

• Do not USe either Of the extra attributes (A challenge password and An optional company 

name). To continue without entering these fields, just press Enter to accept the blank default 
for both inputs. 

The file /etc/httpd/conf /ssi . csr/server . csr is created when you have finished entering 
your information. This file is your certificate request, ready to send to your CA. 

After you have decided on a CA, follow the instructions they provide on their website. Their 
instructions tell you how to send your certificate request, any other documentation that they 
require, and your payment to them. 

After you have fulfilled the CA's requirements, they send a certificate to you (usually by email). 
Save (or cut and paste) the certificate that they send you as 

/etc/httpd/conf /ssi . crt/server . crt. Be sure to keep a backup of this file. 

8. Creating a Self-Signed Certificate 

You can create your own self-signed certificate. Note that a self-signed certificate does not 
provide the security guarantees of a CA-signed certificate. Refer to Section 5, "Types of 
Certificates" for more details about certificates. 

To make your own self-signed certificate, first create a random key using the instructions 
provided in Section 6, "Generating a Key". Once you have a key, make sure you are in the 
/usr/share/ssi/certs/ directory, and type the following command: 

make testcert 
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The following output is shown and you are prompted for your passphrase (unless you generated 
a key without a passphrase): 

umask 7 7 ; \ 

/usr/bin/openssl req -new -key /etc/httpd/conf /ssl . key/server . key 
-x509 -days 365 -out /etc/httpd/conf /ssl . crt/server . crt 
Using configuration from /usr/share/ssl/openssl . cnf 
Enter pass phrase: 

Next, you are asked for more information. The computer's output and a set of inputs looks like 
the following (provide the correct information for your organization and host): 

You are about to be asked to enter information that will be incorporated 
into your certificate request. 

What you are about to enter is what is called a Distinguished Name or a 
DN. 

There are quite a few fields but you can leave some blank 
For some fields there will be a default value, 
If you enter ' . ', the field will be left blank. 



Country Name (2 letter code) [GB] :US 

State or Province Name (full name) [Berkshire] :North CarolinaLocality Name 
(eg, city) [Newbury] : RaleighOrganization Name (eg, company) [My Company 

Ltd] :My Company, Inc . Organizational Unit Name (eg, section) 
[] : DocumentationComraon Name (your name or server's hostname) 
[] :myhost . example . comEmail Address [ ] :myemail@example . com 

After you provide the correct information, a self-signed certificate is created in 

/etc/httpd/conf /ssi . crt/server . crt. Restart the secure server after generating the 
certificate with following the command: 

/ sbin/service httpd restart 

9. Testing The Certificate 

To test the test certificate installed by default, either a CA-signed certificate, or a self-signed 
certificate, point your Web browser to the following home page (replacing server . example . com 
with your domain name): 

https : / / server . example . com 
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^ Note 

f Note the s after http. The https : prefix is used for secure HTTP transactions. 



If you are using a CA-signed certificate from a well-known CA, your browser probably 
automatically accepts the certificate (without prompting you for input) and creates the secure 
connection. Your browser does not automatically recognize a test or a self-signed certificate, 
because the certificate is not signed by a CA. If you are not using a certificate from a CA, follow 
the instructions provided by your browser to accept the certificate. 

Once your browser accepts the certificate, your secure server displays a default home page. 

10. Accessing The Server 

To access your secure server, use a URL similar to the following: 



https : / / server . example . com 



Your non-secure server can be accessed using an URL similar to the following: 



http : / / server . example . com 



The standard port for secure Web communications is port 443. The standard port for 
non-secure Web communications is port 80. The secure server default configuration listens on 
both of the two standard ports. Therefore, do not need to specify the port number in a URL (the 
port number is assumed). 

However, if you configure your server to listen on a non-standard port (for example, anything 
other than 80 or 443), you must specify the port number in every URL which is intended to 
connect to the server on the non-standard port. 

For example, you may have configured your server so that you have a virtual host running 
non-secured on port 1 2331 . Any URLs intended to connect to that virtual host must specify the 
port number in the URL. The following URL example attempts to connect to a non-secure server 
listening on port 12331 : 



http : / / server . example . com: 12 331 



11. Additional Resources 



286 



Useful Websites 



Refer to Section 7, "Additional Resources "for more information about the Apache HTTP Server. 

11.1. Useful Websites 

• http://www.redhat.com/mailman/listinfo/redhat-secure-server — The redhat-secure-server 
mailing list. 

You can also subscribe to the redhat-secure-server mailing list by emailing 

<redhat-secure-server-request@redhat . com> and include the Word Subscribe in the 

subject line. 

• http://www.modssl.org/ — The mod_ssi website is the definitive source for information about 
mod_ssi. The website includes a wealth of documentation, including a User Manual at 

http://www.modssl.org/docs/. 

1 1 .2. Related Books 

• Apache: The Definitive Guide , 2nd edition, by Ben Laurie and Peter Laurie, O'Reilly & 
Associates, Inc. 
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Authentication Configuration 

When a user logs in to a Red Hat Enterprise Linux system, the username and password 
combination must be verified, or authenticated, as a valid and active user. Sometimes the 
information to verify the user is located on the local system, and other times the system defers 
the authentication to a user database on a remote system. 

The Authentication Configuration Tool provides a graphical interface for configuring NIS, 
LDAP, and Hesiod to retrieve user information as well as for configuring LDAP, Kerberos, and 
SMB as authentication protocols. 



Note 



If you configured a medium or high security level during installation or with the 
Security Level Configuration Tool, network authentication methods, including 
NIS and LDAP, are not allowed through the firewall. 



This chapter does not explain each of the different authentication types in detail. Instead, it 
explains how to use the Authentication Configuration Tool to configure them. For more 
information about the specific authentication types, refer to the Red Hat Enterprise Linux 
Reference Guide. 

To start the graphical version of the Authentication Configuration Tool from the desktop, 
select the Main Menu Button (on the Panel) => System Settings => Authentication or type 

the command system-conf ig-authentication at a shell prompt (for example, in an XTerm or 
a GNOME terminal). To start the text-based version, type the command authconf ig as root at 
a shell prompt. 



* 



Important 

After exiting the authentication program, the changes made take effect 
immediately. 



1. User Information 

The User Information tab has several options. To enable an option, click the empty checkbox 
beside it. To disable an option, click the checkbox beside it to clear the checkbox. Click OK to 
exit the program and apply the changes. 
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User Information! Authentication 



NIS 

NIS is the Network Information Service, It is 
commonly used on small to medium networks. 

Enable NIS Support 



Configure NIS,, 



LDAP 



The Lightweight Directory Access Protocol is a 
standard way of searching a directory, which can hold 
arbitrary data in a structured hierarchy, LDAP is 
increasingly being used in small to large networks. 

□ Enable LDAP Support 



Configure LDAP.. 



Hesiod 

Hesiod allows a system administrator to publish 
user and group information in DNS. It is 
sometimes used in very large networks. 

□ Enable Hesiod Support 



Configure Hesiod., 



Winbind 

Winbind allows a system to retrieve information about users 
and to authenticate users by using information stored in an 
NTDOM or ADS server, It is used in small to large networks, 

□ Enable Winbind Support 
□ Cache User Information 



Configure Winbjm 



X Cancel 



<^ OK 



Figure 26.1. User Information 



The following list explains what each option configures: 



Enable NIS Support — Select this option to configure the system as an NIS client which 
connects to an NIS server for user and password authentication. Click the Configure NIS 
button to specify the NIS domain and NIS server. If the NIS server is not specified, the 
daemon attempts to find it via broadcast. 

The ypbind package must be installed for this option to work. If NIS support is enabled, the 
portmap and ypbind services are started and are also enabled to start at boot time. 

Enable LDAP Support — Select this option to configure the system to retrieve user 
information via LDAP. Click the Configure LDAP button to specify the LDAP Search Base 
DN and LDAP Server. If Use TLS to encrypt connections is selected, Transport Layer 
Security is used to encrypt passwords sent to the LDAP server. 

The openidap-ciients package must be installed for this option to work. 

For more information about LDAP, refer to the Red Hat Enterprise Linux Reference Guide. 

Enable Hesiod Support — Select this option to configure the system to retrieve information 
from a remote Hesiod database, including user information. 

The hesiod package must be installed. 

Winbind — Select this option to configure the system to connect to a Windows Active 
Directory or a Windows domain controller. User information can be accessed, as well as 
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server authentication options can be configured. 



Cache User Information — Select this option to enable the name service cache daemon 
(nscd) and configure it to start at boot time. 

The nscd package must be installed for this option to work. 

2. Authentication 

The Authentication tab allows for the configuration of network authentication methods. To 
enable an option, click the empty checkbox beside it. To disable an option, click the checkbox 
beside it to clear the checkbox. 



User Information ^Authentication 



Kerberos — 

Kerberos is a trusted third-party authentication system 
which is commonly used in medium to large networks, 

Enable Kerberos Support Configure Kerberos... 



LDAP 

The Lightweight Directory Access Protocol is a 
standard way of searching a directory, which can hold 
arbitrary data in a structured hierarchy, LDAP is 
increasingly being used in small to large networks. 

□ Enable LDAP Support 



Configure LDAP,,. 



Use Shadow Passwords 



SMB 

SMB authentication verifies user passwords by 
attempting to connect to a server which uses the 
SMB (system message block) protocol suite. 

□ Enable SMB Support Configure SMB., 



Winbind — 

Winbind allows a system to retrieve information about users 
and to authenticate users by using information stored in an 
NTDOM or ADS server. It is used in small to large networks. 

□ Enable Winbind Support 



Configure Winbind. 



Use MD5 Passwords 



X Cancel 



<^ OK 



Figure 26.2. Authentication 



The following explains what each option configures: 



Enable Kerberos Support — Select this option to enable Kerberos authentication. Click the 
Configure Kerberos button to configure: 

• Realm — Configure the realm for the Kerberos server. The realm is the network that uses 
Kerberos, composed of one or more KDCs and a potentially large number of clients. 

• KDC — Define the Key Distribution Center (KDC), which is the server that issues Kerberos 
tickets. 

• Admin Servers — Specify the administration server(s) running kadmind. 

The krb5-libs and krb5 -workstation packages must be installed for this option to work. 
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Refer to the Red Hat Enterprise Linux Reference Guide for more information on Kerberos. 

Enable LDAP Support — Select this option to have standard PAM-enabled applications use 
LDAP for authentication. Click the Configure LDAP button to specify the following: 

• Use TLS to encrypt connections — Use Transport Layer Security to encrypt passwords 
sent to the LDAP server. 

• LDAP Search Base DN — Retrieve user information by its Distinguished Name (DN). 

• LDAP Server — Specify the IP address of the LDAP server. 

The openidap-ciients package must be installed for this option to work. Refer to the Red 
Hat Enterprise Linux Reference Guide for more information about LDAP. 

• 

Use Shadow Passwords — Select this option to store passwords in shadow password 
format in the /etc/shadow file instead of /etc/passwd. Shadow passwords are enabled by 
default during installation and are highly recommended to increase the security of the system. 

The shadow-utiis package must be installed for this option to work. For more information 
about shadow passwords, refer to the Users and Groups chapter in the Red Hat Enterprise 
Linux Reference Guide. 

Enable SMB Support — This option configures PAM to use an SMB server to authenticate 
users. Click the Configure SMB button to specify: 

• Workgroup — Specify the SMB workgroup to use. 

• Domain Controllers — Specify the SMB domain controllers to use. 

Winbind — Select this option to configure the system to connect to a Windows Active 
Directory or a Windows domain controller. User information can be accessed, as well as 
server authentication options can be configured. 

• 

Use MD5 Passwords — Select this option to enable MD5 passwords, which allows 
passwords to be up to 256 characters instead of eight characters or less. It is selected by 
default during installation and is highly recommended for increased security. 

3. Command Line Version 

The Authentication Configuration Tool can also be run as a command line tool with no 
interface. The command line version can be used in a configuration script or a kickstart script. 
The authentication options are summarized in Table 26. 1, "Command Line Options". 
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Tip 

These options can also be found in the authconf ig man page or by typing 

authconfig — help at a shell prompt. 



Option 


Description 


— enable shadow 


Enable shadow passwords 


— disable shadow 


Disable shadow passwords 


— enablemd5 


Enable MD5 passwords 


— disablemd5 


Disable MD5 passwords 


— enablenis 


Enable NIS 


--disablenis 


Disable NIS 


— nisdomain= <domain> 


Specify NIS domain 


— nisserver=<server> 


Specify NIS server 


--enableldap 


Enable LDAP for user information 


— disableldap 


Disable LDAP for user information 


--enableldaptls 


Enable use of TLS with LDAP 


— disableldaptls 


Disable use of TLS with LDAP 


--enableldapauth 


Enable LDAP for authentication 


— disableldapauth 


Disable LDAP for authentication 


— 1 daps erver =<server> 


Specify LDAP server 


— ldapbasedn=<<in> 


opeciTy LUAr case un 


--enablekrb5 


Enable Kerberos 


— disablekrb5 


Disable Kerberos 


--krb5kdc=<^cdc> 


Specify Kerberos KDC 


— krb5adminserver= <server> 


Specify Kerberos administration 
server 


— krb5realm=<realm> 


Specify Kerberos realm 


--enablekrb5kdcdns 


Enable use of DNS to find Kerberos 
KDCs 


— disablekrb5kdcdns 


Disable use of DNS to find Kerberos 
KDCs 


--enablekrb5realmdns 


Enable use of DNS to find Kerberos 
realms 


--disablekrb5realmdns 


Disable use of DNS to find Kerberos 
realms 
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Option 


Description 


--enablesmbauth 


Enable SMB 


— disablesmbauth 


Disable SMB 


— srabworkgr oup= <wor k group> 


Specify SMB workgroup 


— smbservers=<server> 


Specify SMB servers 


--enablewinbind 


Enable winbind for user information 
by default 


--disablewinbind 


Disable winbind for user information 
by default 


--enablewinbindauth 


Enable winbindauth for 
authentication by default 


— disablewinbindauth 


Disable winbindauth for 
authentication by default 


— srabsecurity=<user / server / domain / ads> 


Security mode to use for Samba 
and winbind 


— smbrealm= <STRING> 


Default realm for Samba and 

Winbind When security=ads 


- - s mb i dmapu i d= <1 o we s t -h i gh e s t > 


UID range winbind assigns to 
domain or ADS users 


--smbidmapqid=<lowest-highest> 


GID range winbind assigns to 
domain or ADS users 


— winbindseparator=<\> 


Character used to separate the 
domain and user part of winbind 
usernames if 

winbindusedef aultdomain is not 

enabled 


— winbindtempl at ehomedir =</home/ %D/%U> 


Directory that winbind users have as 
their home 


— winbindtempl at eprimarygroup= <nabody> 


Group that winbind users have as 
their primary group 


— winbindtemplateshell = </ J bin/false> 


Shell that winbind users have as 
their default login shell 


--enablewinbindusede fault domain 


Configures winbind to assume that 
users with no domain in their 
usernames are domain users 


— disablewinbinduse default domain 


Configures winbind to assume that 
users with no domain in their 
usernames are not domain users 


— winbind join=<Administrat or> 


Joins the winbind domain or ADS 
realm now as this administrator 
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Option 


Description 


--enablewins 


1 — 1 1 1 A JIM t~\ Z 1 x 

Enable WINS for hostname 
resolution 


— disablewins 


Disable WINS for hostname 
resolution 


--enablehesiod 


Enable Hesiod 


— disablehesiod 


Disable Hesiod 


— hesiodlhs=<Jhs> 


t~\ "X II 1 1 1 1 (~i 

Specify Hesiod LHS 


— hesiodrhs=<rhs> 


t~\ " £ ii i n i i t~\ 

Specify Hesiod RHS 


--enable cache 


Enable nscd 


— disablecache 


Disable nscd 


— nostart 


Do not start or stop the portmap, 
ypbind, or nscd services even if 
they are configured 


— kickstart 


Do not display the user interface 


--probe 


Probe and display network defaults 



Table 26.1. Command Line Options 
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Part V. System Configuration 

Part of a system administrator's job is configuring the system for various tasks, types of users, 
and hardware configurations. This section explains how to configure a Red Hat Enterprise Linux 
system. 



Chapter 27. 



Console Access 

When normal (non-root) users log into a computer locally, they are given two types of special 
permissions: 



1 . They can run certain programs that they would not otherwise be able to run 

2. They can access certain files (normally special device files used to access diskettes, 
CD-ROMs, and so on) that they would not otherwise be able to access 

Since there are multiple consoles on a single computer and multiple users can be logged into 
the computer locally at the same time, one of the users has to essentially win the race to access 
the files. The first user to log in at the console owns those files. Once the first user logs out, the 
next user who logs in owns the files. 

In contrast, every user who logs in at the console is allowed to run programs that accomplish 
tasks normally restricted to the root user. If X is running, these actions can be included as menu 
items in a graphical user interface. As shipped, the console-accessible programs include halt, 

powero f f , and reboot. 

1. Disabling Shutdown Via Ctrl-Alt-Del 

By default, /etc/inittab specifies that your system is set to shutdown and reboot in response 
to a Ctrl-Alt-Del key combination used at the console. To completely disable this ability, 
comment out the following line in /etc/inittab by putting a hash mark (#) in front of it: 

ca : : ctrlaltdel : /sbin/ shutdown -t3 -r now 

Alternatively, you may want to allow certain non-root users the right to shutdown or reboot the 
system from the console using Ctrl-Alt-Del. You can restrict this privilege to certain users, by 
taking the following steps: 



1 . Add the -a option to the /etc/inittab line shown above, so that it reads: 

ca :: ctrlaltdel : /sbin/ shutdown -a -t3 -r now 

The -a flag tells shutdown to look for the /etc/shutdown, allow file. 

2. Create a file named shutdown . allow in /etc. The shutdown . allow file should list the 
usernames of any users who are allowed to shutdown the system using Ctrl-Alt-Del. The 
format of the shutdown . allow file is a list of usernames, one per line, like the following: 
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Stephen 

jack 

sophie 



According to this example shutdown. allow file, the users Stephen, jack, and sophie are 
allowed to shutdown the system from the console using Ctrl-Alt-Del. When that key 
combination is used, the shutdown -a command in /etc/inittab checks to see if any of the 
users in /etc/shutdown . allow (or root) are logged in on a virtual console. If one of them is, the 
shutdown of the system continues; if not, an error message is written to the system console 
instead. 

For more information on shutdown, allow, refer to the shutdown man page. 

2. Disabling Console Program Access 

To disable access by users to console programs, run the following command as root: 

rm -f /etc/ security/console . apps / * 

In environments where the console is otherwise secured (BIOS and boot loader passwords are 
set, Ctrl-Alt-Delete is disabled, the power and reset switches are disabled, and so forth), you 
may not want to allow any user at the console to run powerof f , halt, and reboot, which are 
accessible from the console by default. 

To remove these abilities, run the following commands as root: 

rm -f /etc/ security/console . apps/powerof f rm -f 

/etc/security/ con sole. apps/haltrm -f /etc/ security/console. apps/ reboot 

3. Defining the Console 

The pam_consoie . so module uses the /etc/security/consoie .perms file to determine the 
permissions for users at the system console. The syntax of the file is very flexible; you can edit 
the file so that these instructions no longer apply. However, the default file has a line that looks 
like this: 

<console>=tty [0-9] [0-9] * vc/ [0-9] [0-9] * : [0-9] \ . [0-9] : [0-9] 

When users log in, they are attached to some sort of named terminal, either an X server with a 

name like : or mymachine.example.com: 1 . 0, Or a device like /dev/ttySO Or /dev/pts/2. 

The default is to define that local virtual consoles and local X servers are considered local, but if 
you want to consider the serial terminal next to you on port /dev/ttysi to also be local, you 
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can change that line to read: 

<console>=tty [0-9] [0-9] * vc/ [0-9] [0-9] * : [0-9] \ . [0-9] :[0-9] /dev/ttySl 



4. Making Files Accessible From the Console 

In /etc/security/consoie .perms, there is a section with lines like: 



<f loppy>=/dev/fd[0-l] * \ 

/dev/f loppy / * /mnt/f loppy* 
<sound>=/dev/dsp* /dev/audio* /dev/midi* \ 

/dev/mixer* /dev/sequencer \ 

/dev/sound/* /dev/beep \ 
/ dev/ snd/* 

<cdrom>=/dev/cdrom* /dev/cdroms/* /dev/cdwriter* /mnt/cdrom* 

You can add your own lines to this section, if necessary. Make sure that any lines you add refer 
to the appropriate device. For example, you could add the following line: 

<scanner>=/dev/scanner /dev/usb/ scanner* 



(Of course, make sure that /dev/scanner is really your scanner and not, say, your hard drive.) 



That is the first step. The second step is to define what is done with those files. Look in the last 

Section Of /etc/security/console .perms for lines similar to: 



<console> 


0660 


<f loppy> 


0660 


root . 


, floppy 


<console> 


0600 


<sound> 


0640 


root 




<console> 


0600 


<cdrom> 


0600 


root . 


, disk 



and add a line like: 



<console> 0600 <scanner> 0600 root 

Then, when you log in at the console, you are given ownership of the /dev/scanner device with 
the permissions of 0600 (readable and writable by you only). When you log out, the device is 
owned by root and still has the permissions 0600 (now readable and writable by root only). 

5. Enabling Console Access for Other Applications 

To make other applications accessible to console users, a bit more work is required. 

First of all, console access only works for applications which reside in /sbin/ or /usr/sbin/, 
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so the application that you wish to run must be there. After verifying that, do the following steps: 

1 . Create a link from the name of your application, such as our sample foo program, to the 

/usr/bin/consolehelper application: 

cd /usr/binln -s consolehelper foo 

2. Create the file /etc/security/console. apps/foo: 
touch /etc/ security/ con sole. apps / foo 

3. Create a PAM configuration file for the foo service in /etc/pam.d/. An easy way to do this is 
to start with a copy of the halt service's PAM configuration file, and then modify the file if you 
want to change the behavior: 

cp /etc/pam . d/halt /etc/pam . d/f oo 

Now, when /usr/bin/foo is executed, consolehelper is called, which authenticates the user 
with the help of /usr/sbin/userheiper. To authenticate the user, consolehelper asks for the 
user's password if /etc/pam.d/ foo is a copy of /etc/pam. d/hait (otherwise, it does precisely 
what is specified in /etc/pam. a./ foo) and then runs /usr/sbin/foo with root permissions. 

In the PAM configuration file, an application can be configured to use the pam_timestamp 
module to remember (or cache) a successful authentication attempt. When an application is 
started and proper authentication is provided (the root password), a timestamp file is created. 
By default, a successful authentication is cached for five minutes. During this time, any other 
application that is configured to use pam_timestamp and run from the same session is 
automatically authenticated for the user — the user does not have to enter the root password 
again. 

This module is included in the pam package. To enable this feature, the PAM configuration file in 
etc/pam.d/ must include the following lines: 

auth sufficient /lib/ security/pam_timestamp . so 
session optional /lib/security/pam_timestamp . so 

The first line that begins with auth should be after any other auth sufficient lines, and the 
line that begins with session should be after any other session optional lines. 

If an application configured to use pam_timestamp is successfully authenticated from the Main 
Menu Button (on the Panel), the icon is dis P la y ecl in tne notification area of the panel if 

you are running the GNOME or KDE desktop environment. After the authentication expires (the 
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default is five minutes), the icon disappears. 

The user can select to forget the cached authentication by clicking on the icon and selecting the 
option to forget authentication. 

6. The floppy Group 

If, for whatever reason, console access is not appropriate for you and your non-root users are 
required access to your system's diskette drive, this can be done using the floppy group. Add 
the user(s) to the floppy group using the tool of your choice. For example, the gpasswd 
command can be used to add user fred to the floppy group: 

gpasswd -a fred floppy 



Now, user fred is able to access the system's diskette drive from the console. 
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Date and Time Configuration 

The Time and Date Properties Tool allows the user to change the system date and time, to 
configure the time zone used by the system, and to setup the Network Time Protocol (NTP) 
daemon to synchronize the system clock with a time server. 

You must be running the X Window System and have root privileges to use the tool. There are 
three ways to start the application: 



• From the desktop, go to Applications (the main menu on the panel) => System Settings => 
Date & Time 

• From the desktop, right-click on the time in the toolbar and select Adjust Date and Time. 

• Type the Command system-conf ig-date, system-conf ig-time, Or dateconf ig at a Shell 

prompt (for example, in an XTerm or a GNOME terminal). 

1. Time and Date Properties 

As shown in Figure 28. 1, "Time and Date Properties", the first tabbed window that appears is for 
configuring the system date and time. 
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Date&Xime Network Time Protocol Time_Zone 
Date Time 
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12 



Current Time: 12:08:10 
Hour : 

Minute : 

Second : 44 



©Help 



Cancel 



$ OK 



Figure 28.1. Time and Date Properties 



To change the date, use the arrows to the left and right of the month to change the month, use 
the arrows to the left and right of the year to change the year, and click on the day of the week 
to change the day of the week. 

To change the time, use the up and down arrow buttons beside the Hour, Minute, and Second 
in the Time section. 

Clicking the OK button applies any changes made to the date and time, the NTP daemon 
settings, and the time zone settings. It also exits the program. 
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2. Network Time Protocol (NTP) Properties 



As shown in Figure 28.2, "NTP Properties", the second tabbed window that appears is for 
configuring NTP. 



Date & Time Network Time Protocol Time Zone 



Your computer can synchronize its clock with a 
remote time server using the Network Time Protocol 



[ZliEnable Network Time Protocol 



NTP Servers 



Server: clock.redhat.com 



0. pool, ntp.org 

1. pool, ntp.org 

2. pool, ntp.org 



v Hide advanced options 
Use Local Time Source 
□ Enable NTP Broadcast 



* Add 



DeletE 



IS Help 



Cancel 



4 OK 



Figure 28.2. NTP Properties 



The Network Time Protocol (NTP) daemon synchronizes the system clock with a remote time 
server or time source. The application allows you to configure an NTP daemon to synchronize 
your system clock with a remote server. To enable this feature, select Enable Network Time 
Protocol. This enables the NTP Servers list and other options. You can choose one of the 
predefined servers, edit a predefined server by clicking the Edit or add a new server name by 
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clicking Add. Your system does not start synchronizing with the NTP server until you click OK. 
After clicking OK, the configuration is saved and the NTP daemon is started (or restarted if it is 
already running). 

Clicking the OK button applies any changes made to the date and time, the NTP daemon 
settings, and the time zone settings. It also exits the program. 

3. Time Zone Configuration 

As shown in Figure 28.3, "Timezone Properties", the third tabbed window that appears is for 
configuring the system time zone. 

To configure the system time zone, click the Time Zone tab. The time zone can be changed by 
either using the interactive map or by choosing the desired time zone from the list below the 
map. To use the map, click on the desired region. The map zooms into the region selected, 
after which you may choose the city specific to your time zone. A red X appears and the time 
zone selection changes in the list below the map. 

Alternatively, you can also use the list below the map. In the same way that the map lets you 
choose a region before choosing a city, the list of time zones is now a treelist, with cities and 
countries grouped within their specific continents. Non-geographic time zones have also been 
added to address needs in the scientific community. 

Click OK to apply the changes and exit the program. 
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Date & Time 



Network Time Protocol 



Time Zone 



Please select the nearest city in your timezone: 



Asia/Krasnoyarsk - Moscow+04 - Yenisei River 



Arnerica/Montserrat 










* 


America/N assau 












A m eri c a/N ew_Yo rk 


Eastern Time 










America/Nipigon 


Eastern Time 


- Ontario & Quebec 


- place 




America/Nome 


Alaska Time ■ 


west Alaska 








< | 




> 





D System clock uses UTC 



IS Help 



Cancel 



$ OK 



Figure 28.3. Timezone Properties 



If your system clock is set to use UTC, select the System clock uses UTC option. UTC stands 
for the Universal Time, Coordinated, also known as Greenwich Mean Time (GMT). Other time 
zones are determined by adding or subtracting from the UTC time. 
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Keyboard Configuration 

The installation program allows users to configure a keyboard layout for their systems. To 
configure a different keyboard layout after installation, use the Keyboard Configuration Tool. 

To start the Keyboard Configuration Tool, select Applications (the main menu on the panel) 
=> System Settings => Keyboard, or type the command system-conf ig-keyboard at a shell 
prompt. 

Figure 29.1. Keyboard Configuration 

Select a keyboard layout from the list (for example, U.S. English) and click OK. For changes to 
take effect, you should log out of your graphical desktop session and log back in. 
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Mouse Configuration 

The installation program allows users to select the type of mouse connected to the system. To 
configure a different mouse type for the system, use the Mouse Configuration Tool. 

To start the Mouse Configuration Tool, type the command system-conf ig-mouse at a shell 
prompt (for example, in an XTerm or GNOME terminal). If the X Window System is not running, 
the text-based version of the tool is started. 

Figure 30.1. Mouse Configuration 

Select the new mouse type for the system. If the specific mouse model is not listed, select one 
of the Generic entries, based on the mouse's number of buttons and its interface. If there is not 
an exact match, select the generic match that is most compatible with the system and the 
mouse. 



Tip 

Select the Generic - Wheel Mouse entry, with the proper mouse port, to enable 
the scroll button on the mouse. 



The scroll button on a wheel mouse can be used as the middle mouse button for cutting text, 
pasting text, and other middle mouse button functions. If the mouse only has two buttons, select 
Emulate 3 buttons to use a two-button mouse as a three-button mouse. When this option 
enabled, clicking the two mouse buttons simultaneously emulates a middle mouse button click. 

If a serial port mouse is selected, click the Serial devices button to configure the correct serial 
device number, such as /dev/ttyso for the mouse. 

Click OK to save the new mouse type. The selection is written to the file 
/etc/sysconf ig/mouse, and the console mouse service, gpm is restarted. The changes are 
also written to the X Window System configuration file /etc/xii/ xorg . con f ; however, the 
mouse type change is not automatically applied to the current X session. To enable the new 
mouse type, log out of the graphical desktop and log back in. 



Tip 

To reset the order of the mouse buttons for a left-handed user, go to Applications 
(the main menu on the panel) => Preferences => Mouse, and select 
Left-handed mouse for the mouse orientation. 
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X Window System Configuration 

During installation, the system's monitor, video card, and display settings are configured. To 
change any of these settings after installation, use the X Configuration Tool. 

To start the X Configuration Tool, go to System (on the panel) => Administration => Display, 

or type the command system-conf ig-dispiay at a shell prompt (for example, in an XTerm or 
GNOME terminal). If the X Window System is not running, a small version of X is started to run 
the program. 

After changing any of the settings, log out of the graphical desktop and log back in to enable the 
changes. 

1. Display Settings 

The Settings tab allows users to change the resolution and color depth. The display of a 
monitor consists of tiny dots called pixels. The number of pixels displayed at one time is called 
the resolution. For example, the resolution 1024x768 means that 1024 horizontal pixels and 768 
vertical pixels are used. The higher the resolution values, the more images the monitor can 
display at one time. 

The color depth of the display determines how many possible colors are displayed. A higher 
color depth means more contrast between colors. 
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Settings Hardware Dual head 



Please select the resolution and color depth that you wish to use: 

/ — — 




Resolution: 



Color Depth: 



1024x768 



Millions of Colors 



Cancel 



4 OK 



Figure 31.1. Display Settings 



2. Display Hardware Settings 



When the X Configuration Tool is started, it probes the monitor and video card. If the hardware 
is probed properly, the information for it is shown on the Hardware tab as shown in Figure 31.2, 
"Display Hardware Settings". 
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Settings Hardware Dual head 




Monitor Type: LCD Panel 1024x768 



a « -P Video Card: S3 Savage4 



Configure, 




Configure. 



Cancel 



4 OK 



Figure 31.2. Display Hardware Settings 



To change the monitor type or any of its settings, click the corresponding Configure button. To 
change the video card type or any of its settings, click the Configure button beside its settings. 



3. Dual Head Display Settings 



If multiple video cards are installed on the system, dual head monitor support is available and is 
configured via the Dual head tab, as shown in Figure 31.3, "Dual Head Display Settings". 
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Settings Hardware Dual head 

/ 



Use dual head 



Second Monitor Type: LCD Panel 1024x768 
Second Video Card: 
Resolution: 



jConfigure, 



S3 Savage4 



1024x768 



Color Depth: 
Desktop layout: 



Millions of Colors 



Spanning Desktops 



Cancel 



4 OK 



Figure 31.3. Dual Head Display Settings 



To enable use of Dual head, check the Use dual head checkbox. 

To configure the second monitor type, click the corresponding Configure button. You can also 
configure the other Dual head settings by using the corresponding drop-down list. 

For the Desktop layout option, selecting Spanning Desktops allows both monitors to use an 
enlarged usable workspace. Selecting Individual Desktops shares the mouse and keyboard 
among the displays, but restricts windows to a single display. 
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Users and Groups 

The control of users and groups is a core element of Red Hat Enterprise Linux system 
administration. 

Users can be either people (meaning accounts tied to physical users) or accounts which exist 
for specific applications to use. 

Groups are logical expressions of organization, tying users together for a common purpose. 
Users within a group can read, write, or execute files owned by that group. 

Each user and group has a unique numerical identification number called a userid (UID) and a 
groupid (GID), respectively. 

A user who creates a file is also the owner and group owner of that file. The file is assigned 
separate read, write, and execute permissions for the owner, the group, and everyone else. The 
file owner can be changed only by the root user, and access permissions can be changed by 
both the root user and file owner. 

Red Hat Enterprise Linux also supports access control lists (ACLs) for files and directories 
which allow permissions for specific users outside of the owner to be set. For more information 
about ACLs, refer to Chapter 14, Access Control Lists. 

1. User and Group Configuration 

The User Manager allows you to view, modify, add, and delete local users and groups. 

To use the User Manager, you must be running the X Window System, have root privileges, 
and have the system-conf ig-users RPM package installed. To start the User Manager from 
the desktop, go to System (on the panel) => Administration => Users & Groups. You can also 
type the command system-conf ig-users at a shell prompt (for example, in an XTerm or a 
GNOME terminal). 



File 


Preferences Help 
















Jo 

Add User 


Add Group 


% % a % 

Properties Delete Help Refresh 






















Search 1 












Iter: 






Apply filter 














Users 


Groups 




User Name 


User ID » 


Primary Group 


Full Name 


Login Shell 


Home Directory 


tfox 


500 


tfox 


Tammy Fox /bin/bash 


/home/tfox 








bfox 


501 


bfox 


Brent Fox 


/bin/bash 


/home/bfox 











Figure 32.1. User Manager 
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To view a list of local users on the system, click the Users tab. To view a list of local groups on 
the system, click the Groups tab. 

To find a specific user or group, type the first few letters of the name in the Search filter field. 
Press Enter or click the Apply filter button. The filtered list is displayed. 

To sort the users or groups, click on the column name. The users or groups are sorted 
according to the value of that column. 

Red Hat Enterprise Linux reserves user IDs below 500 for system users. By default, User 
Manager does not display system users. To view all users, including the system users, go to 
Edit => Preferences and uncheck Hide system users and groups from the dialog box. 

1.1. Adding a New User 

To add a new user, click the Add User button. A window as shown in Figure 32.2, "New User" 
appears. Type the username and full name for the new user in the appropriate fields. Type the 
user's password in the Password and Confirm Password fields. The password must be at 
least six characters. 



Tip 

It is advisable to use a much longer password, as this makes it more difficult for 
an intruder to guess it and access the account without permission. It is also 
recommended that the password not be based on a dictionary term; use a 
combination of letters, numbers and special characters. 



Select a login shell. If you are not sure which shell to select, accept the default value of 
/bin/bash. The default home directory is /home/ <username>/ . You can change the home 
directory that is created for the user, or you can choose not to create the home directory by 
unselecting Create home directory. 

If you select to create the home directory, default configuration files are copied from the 
/etc/skei/ directory into the new home directory. 

Red Hat Enterprise Linux uses a user private group (UPG) scheme. The UPG scheme does not 
add or change anything in the standard UNIX way of handling groups; it offers a new 
convention. Whenever you create a new user, by default, a unique group with the same name 
as the user is created. If you do not want to create this group, unselect Create a private group 
for the user. 

To specify a user ID for the user, select Specify user ID manually. If the option is not selected, 
the next available user ID above 500 is assigned to the new user. Because Red Hat Enterprise 
Linux reserves user IDs below 500 for system users, it is not advisable to manually assign user 
IDs 1-499. 




320 



Modifying User Properties 



Click OK to create the user. 



User Name: 



Full Name: 



Password: 



Confirm Password: 



Login Shell: 



tfox 



Tammy Fox 



/bin/bash 



Create home directory 



Home Directory: /home/tfox 



Create a private group for the user 
Q Specify user ID manually 



UID: 



500 



Cancel 



# OK 



Figure 32.2. New User 



To configure more advanced user properties, such as password expiration, modify the user's 
properties after adding the user. Refer to Section 1.2, "Modifying User Properties" for more 
information. 

1.2. Modifying User Properties 

To view the properties of an existing user, click on the Users tab, select the user from the user 
list, and click Properties from the menu (or choose File => Properties from the pulldown 
menu). A window similar to Figure 32.3, "User Properties" appears. 



321 



Chapter 32. Users and Groups 



Account Info 



User Data 
User Name: 

Full Name: 

Password: 

Confirm Password: 

Home Directory: 

Login Shell: 



Password Info 



Groups 



tfox 



Tammy Fox 



A-A-A-A-A 



/home/tfox 



/bin/bash 



SI Cancel 



# OK 



Figure 32.3. User Properties 



The User Properties window is divided into multiple tabbed pages: 



User Data — Shows the basic user information configured when you added the user. Use 
this tab to change the user's full name, password, home directory, or login shell. 

Account Info — Select Enable account expiration if you want the account to expire on a 
certain date. Enter the date in the provided fields. Select Local password is locked to lock 
the user account and prevent the user from logging into the system. 



Password Info — Displays the date that the user's password last changed. To force the user 
to change passwords after a certain number of days, select Enable password expiration 
and enter a desired value in the Days before change required: field. The number of days 
before the user's password expires, the number of days before the user is warned to change 
passwords, and days before the account becomes inactive can also be changed. 

• Groups — Allows you to view and configure the Primary Group of the user, as well as other 
groups that you want the user to be a member of. 

1.3. Adding a New Group 

To add a new user group, click the Add Group button. A window similar to Figure 32.4, "New 



322 



Modifying Group Properties 



Group "appears. Type the name of the new group to create. To specify a group ID for the new 
group, select Specify group ID manually and select the GID. Note that Red Hat Enterprise 
Linux also reserves group IDs lower than 500 for system groups. 



Group Name: 



rnygroup 



□ Specify group ID manually 

GID: 500 



Cancel 



^ OK 



Figure 32.4. New Group 



Click OK to create the group. The new group appears in the group list. 

1.4. Modifying Group Properties 

To view the properties of an existing group, select the group from the group list and click 
Properties from the menu (or choose File => Properties from the pulldown menu). A window 
similar to Figure 32.5, "Group Properties" appears. 



Group Data 



Group Users 



Group Name: rnygroup 
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Figure 32.5. Group Properties 

The Group Users tab displays which users are members of the group. Use this tab to add or 
remove users from the group. Click OK to save your changes. 

2. User and Group Management Tools 

Managing users and groups can be a tedious task; this is why Red Hat Enterprise Linux 
provides tools and conventions to make them easier to manage. 

The easiest way to manage users and groups is through the graphical application, User 
Manager (system-config-users). For more information on User Manager, refer to Section 1, 
"User and Group Configuration". 

The following command line tools can also be used to manage users and groups: 

• useradd, usermod, and userdei — Industry-standard methods of adding, deleting and 
modifying user accounts 

• groupadd, groupmod, and groupdei — Industry-standard methods of adding, deleting, and 
modifying user groups 

• gpasswd — Industry-standard method of administering the /etc/group file 

• pwck, grpok — Tools used for the verification of the password, group, and associated shadow 
files 

• pwconv, pwunconv — Tools used for the conversion of passwords to shadow passwords and 
back to standard passwords 

2.1. Command Line Configuration 

If you prefer command line tools or do not have the X Window System installed, use this section 
to configure users and groups. 

2.2. Adding a User 

To add a user to the system: 

1 . Issue the useradd command to create a locked user account: 

useradd <username> 

2. Unlock the account by issuing the passwd command to assign a password and set password 
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aging guidelines: 

passwd <username> 



Command line options for useradd are detailed in Table 32.1, "useradd Command Line 
Options". 



Option 


Description 


c ^corniuGnt^ 


< , r<nmmonf-> pan hp yf^jTil^cf^ci \A/ith pn\/ Qtrinn XhiQ nntinn iq 
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generally used to specify the full name of a user. 


-d<home-dir> 


Home directory to be used instead of default /home/ <username>/ 


-e<date> 


Date for the account to be disabled in the format YYYY-MM-DD 


— f.<days> 


Mi imhor nf Ha\/c aftor tho naccwnrrl ovniroc i intil tho q/ttii int ic 

INUIIIUfcM Ul Udyo dllCl lilt- fJdoovvUlU CAfJIItro U 1 1 LI 1 lilt? ClLrlrUUML lo 

disabled. If o is specified, the account is disabled immediately after 
the password expires. If -l is specified, the account is not be 
disabled after the password expires. 


-q<group-name> 


Group name or group number for the user's default group. The 
group must exist prior to being specified here. 


-G<group-list> 


List of additional (other than default) group names or group 
numbers, separated by commas, of which the user is a member. 
The groups must exist prior to being specified here. 


-m 


Create the home directory if it does not exist. 


-M 


Do not create the home directory. 


-n 


Do not create a user private group for the user. 


-r 


Create a system account with a UID less than 500 and without a 
home directory 


-p<password> 


The password encrypted with crypt 


-s 


User's login shell, which defaults to /bin/bash 


-u<uid> 


User ID for the user, which must be unique and greater than 499 



Table 32.1 . useradd Command Line Options 



2.3. Adding a Group 

To add a group to the system, use the command groupadd: 

groupadd <group-name> 

Command line options for groupadd are detailed in Table 32.2, "groupadd Command Line 
Options". 
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Option 


Description 


-g<gi d> 


Group ID for the group, which must be unique and greater than 
499 


-r 


Create a system group with a GID less than 500 


-f 


When used with -q<gid> and <gid> already exists, groupadd will 
choose another unique <gid> for the group. 



Table 32.2. groupadd Command Line Options 



2.4. Password Aging 

For security reasons, it is advisable to require users to change their passwords periodically. This 
can be done when adding or editing a user on the Password Info tab of the User Manager. 

To configure password expiration for a user from a shell prompt, use the chage command, 
followed by an option from Table 32.3, "chage Command Line Options", followed by the 
username of the user. 




Important 

Shadow passwords must be enabled to use the chage command. 



Option 


Description 


-m<days> 


Specifies the minimum number of days between which the user 
must change passwords. If the value is 0, the password does not 
expire. 


-M<days> 


Specifies the maximum number of days for which the password is 
valid. When the number of days specified by this option plus the 
number of days specified with the -d option is less than the current 
day, the user must change passwords before using the account. 


-d<days> 


Specifies the number of days since January 1 , 1 970 the password 
was changed 


-Kdays> 


Specifies the number of inactive days after the password 
expiration before locking the account. If the value is 0, the account 
is not locked after the password expires. 


-E<date> 


Specifies the date on which the account is locked, in the format 
YYYY-MM-DD. Instead of the date, the number of days since 
January 1 , 1970 can also be used. 


-W<days> 


Specifies the number of days before the password expiration date 
to warn the user. 
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Table 32.3. chage Command Line Options 



Tip 

If the chage command is followed directly by a username (with no options), it 
displays the current password aging values and allows them to be changed. 



You can configure a password to expire the first time a user logs in. This forces users to change 
passwords the first time they log in. 



Note 

This process will not work if the user logs in using the SSH protocol. 



1 . Lock the user password — If the user does not exist, use the useradd command to create 
the user account, but do not give it a password so that it remains locked. 

If the password is already enabled, lock it with the command: 

usermod -L username 



2. Force immediate password expiration — Type the following command: 

chage -d username 



This command sets the value for the date the password was last changed to the epoch 
(January 1 , 1970). This value forces immediate password expiration no matter what 
password aging policy, if any, is in place. 

3. Unlock the account — There are two common approaches to this step. The administrator can 
assign an initial password or assign a null password. 



A 



Warning 

Do not use the passwd command to set the password as it disables the 
immediate password expiration just configured. 
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To assign an initial password, use the following steps: 



• Start the command line Python interpreter with the python command. It displays the 
following: 



Python 2.4.3 (#1, Jul 21 


2006, 


08:46:09) [GCC 


4.1.1 20060718 (Red Hat 


4.1.1-9)] on linux2 Type 


"help", 


. "copyright", 


"credits" or "license" for 


more information. >>> 









• At the prompt, type the following commands. Replace < P assword> with the password to 
encrypt and <sait> with a random combination of at least 2 of the following: any 
alphanumeric character, the slash (/) character or a dot (.): 

import crypt; print crypt . crypt (" <password>" ," <salt>" ) 

The output is the encrypted password, similar to ■ i2CsGd8FRcMSM' . 

• Press Ctrl-D to exit the Python interpreter. 

• At the shell, enter the following command (replacing <encrypted-password> with the 
encrypted output of the Python interpreter): 

usermod -p " <encrypted-password>" <username> 

Alternatively, you can assign a null password instead of an initial password. To do this, use 
the following command: 

usermod -p "" username 



Caution 

Using a null password, while convenient, is a highly unsecure practice, as any 
third party can log in first an access the system using the unsecure username. 
Always make sure that the user is ready to log in before unlocking an account 
with a null password. 



In either case, upon initial log in, the user is prompted for a new password. 

2.5. Explaining the Process 

The following steps illustrate what happens if the command useradd juan is issued on a 
system that has shadow passwords enabled: 
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1. A new line for juan is created in /etc/passwd. The line has the following characteristics: 

• It begins with the username juan. 

• There is an x for the password field indicating that the system is using shadow passwords. 

• A UID greater than 499 is created. (Under Red Hat Enterprise Linux, UIDs and GIDs below 
500 are reserved for system use.) 

• A GID greater than 499 is created. 

• The optional GECOS information is left blank. 

• The home directory for juan is set to /home/ juan/. 

• The default shell is set to /bin/bash. 

2. A new line for juan is created in /etc/shadow. The line has the following characteristics: 

• It begins with the username juan. 

• Two exclamation points ( ! !) appear in the password field of the /etc/shadow file, which 
locks the account. 



Note 

V If an encrypted password is passed using the -p flag, it is placed in the 

/etc/shadow file on the new line for the user. 



• The password is set to never expire. 

3. A new line for a group named juan is created in /etc/group. A group with the same name 
as a user is called a user private group. For more information on user private groups, refer to 
Section 1. 1, "Adding a New User". 

The line created in /etc/group has the following characteristics: 

• It begins with the group name juan. 

• An x appears in the password field indicating that the system is using shadow group 
passwords. 

• The GID matches the one listed for user juan in /etc/passwd. 

4. A new line for a group named juan is created in /etc/gshadow. The line has the following 
characteristics: 

• It begins with the group name juan. 
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• An exclamation point ( ! ) appears in the password field of the /etc/gshadow file, which 
locks the group. 

• All other fields are blank. 

5. A directory for user juan is created in the /home/ directory. This directory is owned by user 
juan and group juan. However, it has read, write, and execute privileges only for the user 
juan. All other permissions are denied. 

6. The files within the /etc/skei/ directory (which contain default user settings) are copied into 

the new /home/ juan/ directory. 

At this point, a locked account called juan exists on the system. To activate it, the administrator 
must next assign a password to the account using the passwd command and, optionally, set 
password aging guidelines. 

3. Standard Users 



Table 32.4, "Standard Users" lists the standard users configured in the /etc/passwd file by an 
Everything installation. The groupid (GID) in this table is the primary group for the user. See 
Section 4, "Standard Groups"\or a listing of standard groups. 



User 


UID 


GID 


Home Directory 


Shell 


root 








/ root 


/bin/bash 


bin 


1 


1 


/bin 


/ sbin/nologin 


daemon 


2 


2 


/sbin 


/ sbin/nologin 


adm 


3 


4 


/var /adm 


/ sbin/nologin 


IP 


4 


7 


/var/spool/lpd 


/ sbin/nologin 


sync 


5 





/ sbin 


/bin/ sync 


shutdown 


6 





/ sbin 


/ sbin/ shutdown 


halt 


7 





/ sbin 


/ sbin/halt 


mail 


8 


12 


/var /spool /mail 


/ sbin/nologin 


news 


9 


13 


/etc/news 




uucp 


10 


14 


/var /spool /uucp 


/ sbin/nologin 


operator 


11 





/ root 


/ sbin/nologin 


games 


12 


100 


/ usr /games 


/ sbin/nologin 


gopher 


13 


30 


/var /gopher 


/ sbin/nologin 


ftp 


14 


50 


/var/ f tp 


/ sbin/nologin 


nobody 


99 


99 


/ 


/ sbin/nologin 


rpm 


37 


37 


/var /lib /rpm 


/ sbin/nologin 


vcsa 


69 


69 


/dev 


/ sbin/nologin 



330 



Standard Groups 



User 


UID 


GID 


Home Directory 


Shell 


dbus 


81 


81 


/ 


/ sbin/nologin 


ntp 


38 


38 


/etc/ntp 


/ sbin/nologin 


canna 


39 


39 


/var/ lib /canna 


/ sbin/nologin 


nscd 


28 


28 


/ 


/ sbin/nologin 


rpc 


32 


32 


/ 


/ sbin/nologin 


postfix 


89 


89 


/var/ spool/postfix 


/ sbin/nologin 


mailman 


41 


41 


/var /mailman 


/ sbin/nologin 


named 


25 


25 


/var /named 


/bin/ false 


amanda 


33 


6 


var/ lib/ amanda/ 


/bin/bash 


postgres 


26 


26 


/var/lib/pgsql 


/bin/bash 


exim 


93 


93 


/var /spool /exim 


/ sbin/nologin 


sshd 


74 


74 


/ var /empty/ sshd 


/ sbin/nologin 


rpcuser 


29 


29 


/var / lib/nf s 


/ sbin/nologin 


nsfnobody 


65534 


65534 


/ var /lib/ nf s 


/ sbin/nologin 


pvm 


24 


24 


/us r/ share /pvm3 


/bin/bash 


apache 


48 


48 


/var /www 


/ sbin/nologin 


xfs 


43 


43 


/etc/Xll/f s 


/ sbin/nologin 


gdm 


42 


42 


/var /gdm 


/ sbin/nologin 


htt 


100 


101 


/usr/lib/im 


/ sbin/nologin 


mysql 


27 


27 


/var /lib /mysql 


/bin/bash 


webalizer 


67 


67 


/var /www/usage 


/ sbin/nologin 


mailnull 


47 


47 


/var/spool/mqueue 


/ sbin/nologin 


smmsp 


51 


51 


/ var/spool/mqueue 


/ sbin/nologin 


squid 


23 


23 


/var/spool/ squid 


/ sbin/nologin 


Idap 


55 


55 


/var/lib/ldap 


/bin/ false 


netdump 


34 


34 


/var /crash 


/bin/bash 


pcap 


77 


77 


/var /arpwatch 


/ sbin/nologin 


radiusd 


95 


95 


/ 


/bin/ false 


radvd 


75 


75 


/ 


/ sbin/nologin 


quagga 


92 


92 


/var/ run /quagga 


/ sbin/login 


wnn 


49 


49 


/var/lib/wnn 


/ sbin/nologin 


dovecot 


97 


97 


/usr /libexec/ dove cot 


/ sbin/nologin 



Table 32.4. Standard Users 
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4. Standard Groups 



Table 32.5, "Standard Groups" lists the standard groups configured by an Everything 
installation. Groups are stored in the /etc/group file. 



Group 


GID 


Members 


root 


n 
u 


root 


bin 


i 


roox, Din, aaemon 


daemon 


o 
c. 


root, Din, aaemon 


sys 


q 
O 


root, Din, aum 


adm 




roox, aam, aaemon 


tty 







disk 





root 


In 


7 


aaemon, ip 


mom 
1 1 lei 1 1 


Q 





KiTiern 


Q 




\A/nQQ 


1 n 
I u 


root 


mail 


I c. 


mail, posuix, exim 


H6WS 


1 T 
I o 


H6WS 


uucp 


1 


uucp 


man 


I 




games 


on 




gopner 






dip 


An 




ftn 
Tip 


ou 




lock 


O'f 




nououy 


yy 




i i co re 


1 nn 

I uu 




rpm 


37 




utmp 


22 




floppy 


19 




vesa 


69 




dbus 


81 




ntp 


38 




canna 


39 




nscd 


28 




rpc 


32 
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Group 


GID 


Members 


postdrop 


90 




postfix 


89 




mailman 


41 




exim 


93 




named 


25 




postgres 


26 




sshd 


74 




rpcuser 


29 




nfsnobody 


65534 




pvm 


24 




apache 


48 




xfs 


43 




gdm 


42 




htt 


101 




mysql 


27 




webalizer 


67 




mailnull 


47 




smmsp 


51 




squid 


23 




Idap 


55 




netdump 


34 




pcap 


77 




quaggavt 


102 




quagga 


92 




radvd 


75 




s locate 


21 




wnn 


49 




dovecot 


97 




radiusd 


95 





Table 32.5. Standard Groups 



5. User Private Groups 

Red Hat Enterprise Linux uses a user private group (UPG) scheme, which makes UNIX groups 
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easier to manage. 

A UPG is created whenever a new user is added to the system. A UPG has the same name as 
the user for which it was created and that user is the only member of the UPG. 

UPGs make it safe to set default permissions for a newly created file or directory, allowing both 
the user and the group of that user to make modifications to the file or directory. 

The setting which determines what permissions are applied to a newly created file or directory is 
called a umask and is configured in the /etc/bashrc file. Traditionally on UNIX systems, the 
umask is set to 022, which allows only the user who created the file or directory to make 
modifications. Under this scheme, all other users, including members of the creator's group, are 
not allowed to make any modifications. However, under the UPG scheme, this "group 
protection" is not necessary since every user has their own private group. 

5.1. Group Directories 

Many IT organizations like to create a group for each major project and then assign people to 
the group if they need to access that project's files. Using this traditional scheme, managing files 
has been difficult; when someone creates a file, it is associated with the primary group to which 
they belong. When a single person works on multiple projects, it is difficult to associate the right 
files with the right group. Using the UPG scheme, however, groups are automatically assigned 
to files created within a directory with the setgid bit set. The setgid bit makes managing group 
projects that share a common directory very simple because any files a user creates within the 
directory are owned by the group which owns the directory. 

Let us say, for example, that a group of people need to work on files in the 
/usr/share/emacs/site-iisp/ directory. Some people are trusted to modify the directory, but 
certainly not everyone is trusted. First create an emacs group, as in the following command: 

/usr / sbin/groupadd emacs 

To associate the contents of the directory with the emacs group, type: 

chown -R root. emacs /usr/share/emacs / site-lisp 



Now, it is possible to add the proper users to the group with the gpasswd command: 

/usr/bin/gpasswd -a <username> emacs 

To allow users to create files within the directory, use the following command: 

chmod 775 /usr / share/emacs / site-lisp 

When a user creates a new file, it is assigned the group of the user's default private group. 
Next, set the setgid bit, which assigns everything created in the directory the same group 
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permission as the directory itself (emacs). Use the following command: 

chmod 2775 /usr/share/emacs/site-lisp 

At this point, because the default umask of each user is 002, all members of the emacs group 
can create and edit files in the /usr/share/emacs/site-iisp/ directory without the 
administrator having to change file permissions every time users write new files. 

6. Shadow Passwords 

In multiuser environments it is very important to use shadow passwords (provided by the 
shadow-utiis package). Doing so enhances the security of system authentication files. For this 
reason, the installation program enables shadow passwords by default. 

The following lists the advantages pf shadow passwords have over the traditional way of storing 
passwords on UNIX-based systems: 



• Improves system security by moving encrypted password hashes from the world-readable 

/etc/passwd file to /etc/shadow, which is readable only by the root user. 

• Stores information about password aging. 

• Allows the use the /etc/iogin.defs file to enforce security policies. 

Most utilities provided by the shadow-utiis package work properly whether or not shadow 
passwords are enabled. However, since password aging information is stored exclusively in the 
/etc/ shadow file, any commands which create or modify password aging information do not 
work. 

The following is a list of commands which do not work without first enabling shadow passwords: 



• chage 

• gpasswd 

• /usr/sbin/usermod-e Or -f Options 

• /usr/sbin/useradd-e Or -f options 

7. Additional Resources 

For more information about users and groups, and tools to manage them, refer to the following 
resources. 

7.1. Installed Documentation 
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• Related man pages — There are a number of man pages for the various applications and 
configuration files involved with managing users and groups. Some of the more important 
man pages have been listed here: 

User and Group Administrative Applications 

• man chage — A command to modify password aging policies and account expiration. 

• man gpasswd — A command to administer the /etc/group file. 

• man groupadd — A command to add groups. 

• man grpck — A Command tO Verify the /etc/group file. 

• man groupdei — A command to remove groups. 

• man groupmod — A command to modify group membership. 

• man pwck — A command to verify the /etc/passwd and /etc/shadow files. 

• man pwconv — A tool to convert standard passwords to shadow passwords. 

• man pwunconv — A tool to convert shadow passwords to standard passwords. 

• man useradd — A command to add users. 

• man userdei — A command to remove users. 

• man usermod — A command to modify users. 
Configuration Files 

• man 5 group — The file containing group information for the system. 

• man 5 passwd — The file containing user information for the system. 

• man 5 shadow — The file containing passwords and account expiration information for 
the system. 
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Printer Configuration 

Printer Configuration Tool allows users to configure a printer. This tool helps maintain the 
printer configuration file, print spool directories, print filters, and printer classes. 

Red Hat Enterprise Linux 5.0.0 uses the Common Unix Printing System (CUPS). If a system 
was upgraded from a previous Red Hat Enterprise Linux version that used CUPS, the upgrade 
process preserves the configured queues. 

Using Printer Configuration Tool requires root privileges. To start the application, select 
System (on the panel) => Administration => Printing, or type the command 

system-conf ig-printer at a Shell prompt. 



s 

Action Test Help 


\ a := 

New Edit 


Delete Default Apply 


Queue name * 


Default 


Description 


printer 




my printer 





Figure 33.1. Printer Configuration Tool 



The following types of print queues can be configured: 



• AppSocket/HP JetDirect — a printer connected directly to the network through HP JetDirect 
or Appsocket interface instead of a computer. 

• Internet Printing Protocol (IPP) — a printer that can be accessed over a TCP/IP network via 
the Internet Printing Protocol (for example, a printer attached to another Red Hat Enterprise 
Linux system running CUPS on the network). 

• LPD/LPR Host or Printer — a printer attached to a different UNIX system that can be 
accessed over a TCP/IP network (for example, a printer attached to another Red Hat 
Enterprise Linux system running LPD on the network). 

• Networked Windows (SMB) — a printer attached to a different system which is sharing a 
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printer over an SMB network (for example, a printer attached to a Microsoft Windows™ 
machine). 

Networked JetDirect — a printer connected directly to the network through HP JetDirect 
instead of a computer. 



Important 

If you add a new print queue or modify an existing one, you must apply the 
changes for them to take effect. 



Clicking the Apply button prompts the printer daemon to restart with the changes you have 
configured. 

Clicking the Revert button discards unapplied changes. 

1. Adding a Local Printer 

To add a local printer, such as one attached through a parallel port or USB port on your 
computer, click the New Printer button in the main Printer Configuration Tool window to 
display the window in Figure 33.2, "Adding a Printer ". 



Add a new print queue 




On the following screens, you will be asked to provide basic 
information for adding a new print queue, You will be able to 
edit the more advanced options afterwards. 

Nothing will be done to your settings until you hit "Finish" on 
the last screen. 



Cancel 



Back 



^ Eorward 



Figure 33.2. Adding a Printer 



Click Forward to proceed. 
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Enter a unique name for the printer in the Printer Name field. The printer name can contain 
letters, numbers, dashes (-), and underscores (_); it must not contain any spaces. 

You can also use the Description and Location fields to further distinguish this printer from 
others that may be configured on your system. Both of these fields are optional, and may 
contain spaces. 

Click Forward to open the New Printer dialogue (refer to Figure 33.3, "Adding a Local Printer'). 
If the printer has been automatically detected, the printer model appears in Select Connection. 
Select the printer model and click Forward to continue. 

If the device does not automatically appear, select the device to which the printer is connected 
(such as LPT #1 or Serial Port #1) in Select Connection. 



Queue type 



Select a queue type: 



Locally-connected 



/dev/lpO 




fe^Rescan devices 


Custom device 





Help 



5? Cancel 



<3 B_ack j Forward 



Figure 33.3. Adding a Local Printer 



Next, select the printer type. Refer to Section 5, "Selecting the Printer Model and Finishing" for 
details. 

2. Adding an IPP Printer 

An IPP printer is a printer attached to a different system on the same TCP/IP network. The 
system this printer is attached to may either be running CUPS or simply configured to use IPP. 

If a firewall is enabled on the printer server, then the firewall should be configured to allow send 
/ receive connections on the incoming UDP port 631 . If a firewall is enabled on on the client (the 
system sending the print request) then the firewall must be allowed to accept and create 
connections through port 631 . 
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You can add a networked IPP printer by clicking the New Printer button in the main Printer 
Configuration Tool window to display the window in Figure 33.2, "Adding a Printer". Enter the 
Printer Name (printer names cannot contain spaces and may contain letters, numbers, dashes 
(-), and underscores (_)), Description, and Location to distinguish this printer from others that 
you may configure on your system. Click Forward to proceed. 

In the window shown in Figure 33.4, "Adding an IPP Printer", enter the hostname of the IPP 
printer in the Hostname field as well as a unique name for the printer in the Printername field. 



Queue type 



Select a queue type: 



Networked CUPS (IPP) 



Server: 



Path: 



servemame.example.com 



/printers/queuel 



^Help 



U Cancel 



<] B ack [> Forward 



Figure 33.4. Adding an IPP Printer 



Click Forward to continue. 

Next, select the printer type. Refer to Section 5, "Selecting the Printer Model and Finishing" for 
details. 

3. Adding a Samba (SMB) Printer 

You can add a Samba (SMB) based printer share by clicking the New Printer button in the main 
Printer Configuration Tool window to display the window in Figure 33.2, "Adding a Printer". 
Enter a unique name for the printer in the Printer Name field. The printer name can contain 
letters, numbers, dashes (-), and underscores (_); it must not contain any spaces. 

You can also use the Description and Location fields to further distinguish this printer from 
others that may be configured on your system. Both of these fields are optional, and may 
contain spaces. 
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Queue type 



Select a queue type: 



Networked Windows (SMB) 



^ SNOWBIRD 




Specify,,, 


IP 







5? Cancel 



<3 B ack [> Forward 



Figure 33.5. Adding a SMB Printer 



As shown in Figure 33.5, "Adding a SMB Printer", available SMB shares are automatically 
detected and listed in the Share column. Click the arrow ( ) beside a Workgroup to expand it. 
From the expanded list, select a printer. 

If the printer you are looking for does not appear in the list, enter the SMB address in the smb:// 
field. Use the format computer name/printer share. In Figure 33.5, "Adding a SMB Printer", 

the computer name is dellbox, While the printer share is r2. 

In the Username field, enter the username to access the printer. This user must exist on the 
SMB system, and the user must have permission to access the printer. The default user name 
is typically guest for Windows servers, or nobody for Samba servers. 

Enter the Password (if required) for the user specified in the Username field. 

You can then test the connection by clicking Verify. Upon successful verification, a dialog box 
appears confirming printer share accessibility. 

Next, select the printer type. Refer to Section 5, "Selecting the Printer Model and Finishing" for 
details. 



A 



Warning 

Samba printer usernames and passwords are stored in the printer server as 
unencrypted files readable by root and Ipd. Thus, other users that have root 
access to the printer server can view the username and password you use to 
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access the Samba printer. 

As such, when you choose a username and password to access a Samba 
printer, it is advisable that you choose a password that is different from what you 
use to access your local Red Hat Enterprise Linux system. 

If there are files shared on the Samba print server, it is recommended that they 
also use a password different from what is used by the print queue. 



4. Adding a JetDirect Printer 



To add a JetDirect or AppSocket connected printer share, click the New Printer button in the 
main Printer Configuration Tool window to display the window in Figure 33.2, "Adding a 
Printer ". Enter a unique name for the printer in the Printer Name field. The printer name can 
contain letters, numbers, dashes (-), and underscores (_); it must not contain any spaces. 

You can also use the Description and Location fields to further distinguish this printer from 
others that may be configured on your system. Both of these fields are optional, and may 
contain spaces. 



Queue type 



Select a queue type: 



Networked JetDirect 



Printer: 



Port: 



printer, example.com 



9100 



Help 



5? Cancel 



<] B ack [> Forward 



Figure 33.6. Adding a JetDirect Printer 



Click Forward to continue. 

Text fields for the following options appear: 
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• Hostname — The hostname or IP address of the JetDirect printer. 

• Port Number — The port on the JetDirect printer that is listening for print jobs. The default 
port is 9100. 

Next, select the printer type. Refer to Section 5, "Selecting the Printer Model and Finishing" for 
details. 

5. Selecting the Printer Model and Finishing 

Once you have properly selected a printer queue type, you can choose either option: 

• Select a Printer from database - If you select this option, choose the make of your printer from 
the list of Makes. If your printer make is not listed, choose Generic. 

• Provide PPD file - A PostScript Printer Description (PPD) file may also be provided with your 
printer. This file is normally provided by the manufacturer. If you are provided with a PPD file, 
you can choose this option and use the browser bar below the option description to select the 
PPD file. 



Refer to Figure 33.7, "Selecting a Printer Model". 





I Printer model I 




Select the printer manufacturer and model. 


Notes... 






HP 




2Q0QC 






2500C 

2500CM 

2563 




©Kelp Cancel <]Back 


P> Forward 



Figure 33.7. Selecting a Printer Model 



After choosing an option, click Forward to continue. Figure 33.7, "Selecting a Printer Model" 
appears. You now have to choose the corresponding model and driver for the printer. 
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The recommended printed driver is automatically selected based on the printer model you 
chose. The print driver processes the data that you want to print into a format the printer can 
understand. Since a local printer is attached directly to your computer, you need a printer driver 
to process the data that is sent to the printer. 

If you have a PPD file for the device (usually provided by the manufacturer), you can select it by 
choosing Provide PPD file. You can then browse the filesystem for the PPD file by clicking 
Browse. 

5.1. Confirming Printer Configuration 

The last step is to confirm your printer configuration. Click Apply to add the print queue if the 
settings are correct. Click Back to modify the printer configuration. 

After applying the changes, print a test page to ensure the configuration is correct. Refer to 
Section 6, "Printing a Test Page" for details. 

6. Printing a Test Page 

After you have configured your printer, you should print a test page to make sure the printer is 
functioning properly. To print a test page, select the printer that you want to try out from the 
printer list, then click Print Test Page from the printer's Settings tab. 

If you change the print driver or modify the driver options, you should print a test page to test 
the different configuration. 

7. Modifying Existing Printers 

To delete an existing printer, select the printer and click the Delete button on the toolbar. The 
printer is removed from the printer list once you confirm deletion of the printer configuration. 

To set the default printer, select the printer from the printer list and click the Make Default 
Printer button in the Settings tab. 

7.1 . The Settings Tab 

To change printer driver configuration, click the corresponding name in the Printer list and click 
the Settings tab. 

You can modify printer settings such as make and model, make a printer the default, print a test 
page, change the device location (URI), and more. 

Figure 33.8. Settings Tab 

7.2. The Policies Tab 
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To change settings in print output, click the Policies tab. 

For example, to create a banner page (a page that describes aspects of the print job such as 
the originating printer, the username from the which the job originated, and the security status of 
the document being printed) click the Starting Banner or Ending Banner drop-menu and 
choose the option that best describes the nature of the print jobs (such as topsecret, 
classified, or confidential). 

Figure 33.9. Policies Tab 

You can also configure the Error Policy of the printer, by choosing an option from the 
drop-down menu. You can choose to abort the print job, retry, or stop it. 

7.3. The Access Control Tab 

You can change user-level access to the configured printer by clicking the Access Control tab. 

Add users using the text box and click the Add button beside it. You can then choose to only 
allow use of the printer to that subset of users or deny use to those users. 

Figure 33.10. Access Control Tab 

7.4. The Printer and Job OptionsTab 

The Printer Options tab contains various configuration options for the printer media and output. 
Figure 33.11. Printer Options Tab 



• Page Size — Allows the paper size to be selected. The options include US Letter, US Legal, 
A3, and A4 

• Media Source — set to Automatic by default. Change this option to use paper from a 
different tray. 

• Media Type — Allows you to change paper type. Options include: Plain, thick, bond, and 
transparency. 

• Resolution — Configure the quality and detail of the printout (default is 300 dots per inch 
(dpi). 

• Toner Saving — Choose whether the printer uses less toner to conserve resources. 
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You can also configure printer job options using the Job Options tab. Use the drop-menu and 
choose the job options you wish to use, such as Landscape modes (horizontal or vertical 
printout), copies, or scaling (increase or decrease the size of the printable area, which can be 
used to fit an oversize print area onto a smaller physical sheet of print medium). 

8. Managing Print Jobs 

When you send a print job to the printer daemon, such as printing a text file from Emacs or 
printing an image from The GIMP, the print job is added to the print spool queue. The print 
spool queue is a list of print jobs that have been sent to the printer and information about each 
print request, such as the status of the request, the the job number, and more. 

During the printing process, the Printer Status icon appears in the Notification Area on the 
panel. To check the status of a print job, double click the Printer Status, which displays a 
window similar to Figure 33. 12, "GNOME Print Status". 

Figure 33.12. GNOME Print Status 

To cancel a specific print job listed in the GNOME Print Status, select it from the list and select 
Edit => Cancel Documents from the pulldown menu. 

To view the list of print jobs in the print spool from a shell prompt, type the command lpq. The 
last few lines look similar to the following: 



Rank 


Owner/ID 


Class 


Job 


Files 


Size 


Time 


active 


user@localhost+902 


A 


902 


sample . txt 


2050 


01:20:46 



Example 33.1. Example of i Pq output 



If you want to cancel a print job, find the job number of the request with the command lpq and 
then use the command lprm job number. For example, lprm 902 would cancel the print job in 
Example 33. 1, "Example of ipq output". You must have proper permissions to cancel a print 
job. You can not cancel print jobs that were started by other users unless you are logged in as 
root on the machine to which the printer is attached. 

You can also print a file directly from a shell prompt. For example, the command ipr 

sample . txt prints the text file sample . txt. The print filter determines what type of file it is and 

converts it into a format the printer can understand. 

9. Additional Resources 

To learn more about printing on Red Hat Enterprise Linux, refer to the following resources. 
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9.1. Installed Documentation 



• map lpr — The manual page for the ipr command that allows you to print files from the 
command line. 

• man lprm — The manual page for the command line utility to remove print jobs from the print 
queue. 

• man mpage — The manual page for the command line utility to print multiple pages on one 
sheet of paper. 

• man cupsd — The manual page for the CUPS printer daemon. 

• man cupsd . conf — The manual page for the CUPS printer daemon configuration file. 

• man classes . conf — The manual page for the class configuration file for CUPS. 

9.2. Useful Websites 

• http://www.linuxprinting.org — GNU/Linux Printing contains a large amount of information 
about printing in Linux. 

• http://www.cups.org/ — Documentation, FAQs, and newsgroups about CUPS. 
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Automated Tasks 

In Linux, tasks can be configured to run automatically within a specified period of time, on a 
specified date, or when the system load average is below a specified number. Red Hat 
Enterprise Linux is pre-configured to run important system tasks to keep the system updated. 
For example, the slocate database used by the locate command is updated daily. A system 
administrator can use automated tasks to perform periodic backups, monitor the system, run 
custom scripts, and more. 

Red Hat Enterprise Linux comes with several automated tasks utilities: cron, at, and batch. 

1. Cron 

Cron is a daemon that can be used to schedule the execution of recurring tasks according to a 
combination of the time, day of the month, month, day of the week, and week. 

Cron assumes that the system is on continuously. If the system is not on when a task is 
scheduled, it is not executed. To schedule one-time tasks, refer to Section 2, "At and Batch". 

To use the cron service, the vixie-cron RPM package must be installed and the crond service 
must be running. To determine if the package is installed, use the rpm -q vixie-cron 
command. To determine if the service is running, use the command /sbin/service crond 

status. 

1.1. Configuring Cron Tasks 



The main configuration file for cron, /etc/crontab, contains the following lines: 



SHELL=/bin/bash 








PATH=/sbin: /bin: 


: /usr / sbin : 


: /usr/bin 




MAILTO=root 








HOME=/ 








# run-parts 








01 * * * * root 


run-parts 


/ etc/ cron 


. hourly 


02 4 * * * root 


run-parts 


/ etc/ cron . 


. daily 


22 4 * * root 


run-parts 


/ etc/ cron . 


. weekly 


42 4 1 * * root 


run-parts 


/ etc/ cron . 


. monthly 



The first four lines are variables used to configure the environment in which the cron tasks are 
run. The shell variable tells the system which shell environment to use (in this example the 
bash shell), while the path variable defines the path used to execute commands. The output of 
the cron tasks are emailed to the username defined with the mailto variable. If the mailto 
variable is defined as an empty string (mailto""), email is not sent. The home variable can be 
used to set the home directory to use when executing commands or scripts. 

Each line in the /etc/crontab file represents a task and has the following format: 



349 



Chapter 34. Automated Tasks 



minute hour day month dayofweek command 



• minute — any integer from to 59 

• hour — any integer from to 23 

• day — any integer from 1 to 31 (must be a valid day if a month is specified) 

• month — any integer from 1 to 12 (or the short name of the month such as jan or feb) 

• dayofweek — any integer from to 7, where or 7 represents Sunday (or the short name of 
the week such as sun or mon) 

• command — the command to execute (the command can either be a command such as is 
/proc >> /tmp/proc or the command to execute a custom script) 

For any of the above values, an asterisk (*) can be used to specify all valid values. For example, 
an asterisk for the month value means execute the command every month within the constraints 
of the other values. 

A hyphen (-) between integers specifies a range of integers. For example, 1-4 means the 
integers 1 , 2, 3, and 4. 

A list of values separated by commas (,) specifies a list. For example, 3, 4, 6, 8 indicates 
those four specific integers. 

The forward slash (/) can be used to specify step values. The value of an integer can be 
skipped within a range by following the range with /<integer>. For example, 0-59/2 can be 
used to define every other minute in the minute field. Step values can also be used with an 
asterisk. For instance, the value */3 can be used in the month field to run the task every third 
month. 

Any lines that begin with a hash mark (#) are comments and are not processed. 
As shown in the /etc/crontab file, the run-parts script executes the scripts in the 

/etc/cron . hourly/, /etc/cron . daily/, /etc/cron . weekly/, and /etc/cron . monthly / 

directories on an hourly, daily, weekly, or monthly basis respectively. The files in these 
directories should be shell scripts. 

If a cron task is required to be executed on a schedule other than hourly, daily, weekly, or 
monthly, it can be added to the /etc/cron . a/ directory. All files in this directory use the same 
syntax as /etc/crontab. Refer to Example 34. 1, "Crontab Examples"tor examples. 



# record the memory usage of the system every monday 

# at 3:30AM in the file /tmp/meminfo 

30 3 * * mon cat /proc/meminf o >> /tmp/meminfo 
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# run custom script the first day of every month at 4:10AM 
10 4 1 * * /root / script s /backup . sh 

Example 34.1. Crontab Examples 

Users other than root can configure cron tasks by using the crontab utility. All user-defined 
crontabs are stored in the /var/spooi/cron/ directory and are executed using the usernames 
of the users that created them. To create a crontab as a user, login as that user and type the 
command crontab -e to edit the user's crontab using the editor specified by the visual or 
editor environment variable. The file uses the same format as /etc/crontab. When the 
changes to the crontab are saved, the crontab is stored according to username and written to 

the file /va r/ spool/ cron/ username. 

The cron daemon checks the /etc/crontab file, the /etc/cron. d/ directory, and the 
/var/spooi/cron/ directory every minute for any changes. If any changes are found, they are 
loaded into memory. Thus, the daemon does not need to be restarted if a crontab file is 
changed. 

1.2. Controlling Access to Cron 

The /etc/cron . allow and /etc/cron . deny files are used to restrict access to cron. The 
format of both access control files is one username on each line. Whitespace is not permitted in 
either file. The cron daemon (crond) does not have to be restarted if the access control files are 
modified. The access control files are read each time a user tries to add or delete a cron task. 

The root user can always use cron, regardless of the usernames listed in the access control 
files. 

If the file cron . allow exists, only users listed in it are allowed to use cron, and the cron . deny 
file is ignored. 

If cron . allow does not exist, users listed in cron . deny are not allowed to use cron. 

1.3. Starting and Stopping the Service 

To start the cron service, use the command /sbin/service crond start. To stop the service, 
use the command /sbin/service crond stop. It is recommended that you start the service at 
boot time. Refer to Chapter 19, Controlling Access to Services for details on starting the cron 
service automatically at boot time. 

2. At and Batch 

While cron is used to schedule recurring tasks, the at command is used to schedule a one-time 
task at a specific time and the batch command is used to schedule a one-time task to be 
executed when the systems load average drops below 0.8. 
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To use at or batch, the at RPM package must be installed, and the atd service must be 
running. To determine if the package is installed, use the rpm -q at command. To determine if 
the service is running, use the command /sbin/service atd status. 

2.1. Configuring At Jobs 

To schedule a one-time job at a specific time, type the command at time, where time is the 
time to execute the command. 

The argument time can be one of the following: 



• HH:MM format — For example, 04:00 specifies 4:00 a.m. If the time is already past, it is 
executed at the specified time the next day. 

• midnight — Specifies 12:00 a.m. 

• noon — Specifies 12:00 p.m. 

• teatime — Specifies 4:00 p.m. 

• month-name day year format — For example, January 1 5 2002 specifies the 1 5th day of 
January in the year 2002. The year is optional. 

• MMDDYY, MM/DD/YY, or MM.DD.YY formats — For example, 01 1502 for the 15th day of 
January in the year 2002. 

• now + time — time is in minutes, hours, days, or weeks. For example, now + 5 days specifies 
that the command should be executed at the same time five days from now. 

The time must be specified first, followed by the optional date. For more information about the 

time format, read the /usr/share/doc/at-<rersion>/timespec text file. 

After typing the at command with the time argument, the at> prompt is displayed. Type the 
command to execute, press Enter, and type Ctrl-D. Multiple commands can be specified by 
typing each command followed by the Enter key. After typing all the commands, press Enter to 
go to a blank line and type Ctrl-D. Alternatively, a shell script can be entered at the prompt, 
pressing Enter after each line in the script, and typing Ctrl-D on a blank line to exit. If a script is 
entered, the shell used is the shell set in the user's shell environment, the user's login shell, or 
/bin/sh (whichever is found first). 

If the set of commands or script tries to display information to standard out, the output is 
emailed to the user. 

Use the command atq to view pending jobs. Refer to Section 2.3, "Viewing Pending Jobs" for 
more information. 

Usage of the at command can be restricted. For more information, refer to Section 2.5, 
"Controlling Access to At and Batch" tor details. 
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2.2. Configuring Batch Jobs 

To execute a one-time task when the load average is below 0.8, use the batch command. 

After typing the batch command, the at> prompt is displayed. Type the command to execute, 
press Enter, and type Ctrl-D. Multiple commands can be specified by typing each command 
followed by the Enter key. After typing all the commands, press Enter to go to a blank line and 
type Ctrl-D. Alternatively, a shell script can be entered at the prompt, pressing Enter after each 
line in the script, and typing Ctrl-D on a blank line to exit. If a script is entered, the shell used is 
the shell set in the user's shell environment, the user's login shell, or /bin/sh (whichever is 
found first). As soon as the load average is below 0.8, the set of commands or script is 
executed. 

If the set of commands or script tries to display information to standard out, the output is 
emailed to the user. 

Use the command atq to view pending jobs. Refer to Section 2.3, "Viewing Pending Jobs" tor 
more information. 

Usage of the batch command can be restricted. For more information, refer to Section 2.5, 
"Controlling Access to At and Batch" tor details. 

2.3. Viewing Pending Jobs 

To view pending at and batch jobs, use the atq command. The atq command displays a list of 
pending jobs, with each job on a line. Each line follows the job number, date, hour, job class, 
and username format. Users can only view their own jobs. If the root user executes the atq 
command, all jobs for all users are displayed. 

2.4. Additional Command Line Options 



Additional command line options for at and batch include: 



Option 


Description 


-f 


Read the commands or shell script from a file instead of specifying 
them at the prompt. 


-m 


Send email to the user when the job has been completed. 


-v 


Display the time that the job is executed. 



Table 34.1. at and batch Command Line Options 



2.5. Controlling Access to At and Batch 

The /etc/at . allow and /etc/at . deny files can be used to restrict access to the at and batch 
commands. The format of both access control files is one username on each line. Whitespace is 
not permitted in either file. The at daemon (atd) does not have to be restarted if the access 
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control files are modified. The access control files are read each time a user tries to execute the 
at or batch commands. 

The root user can always execute at and batch commands, regardless of the access control 
files. 

If the file at . allow exists, only users listed in it are allowed to use at or batch, and the 
at .deny file is ignored. 

If at . allow does not exist, users listed in at . deny are not allowed to use at or batch. 

2.6. Starting and Stopping the Service 

To start the at service, use the command /sbin/service atd start. To stop the service, use 
the command /sbin/service atd stop. It is recommended that you start the service at boot 
time. Refer to Chapter 19, Controlling Access to Services tor details on starting the cron service 
automatically at boot time. 

3. Additional Resources 

To learn more about configuring automated tasks, refer to the following resources. 

3.1. Installed Documentation 

• cron man page — overview of cron. 

• crontab man pages in sections 1 and 5 — The man page in section 1 contains an overview 
of the crontab file. The man page in section 5 contains the format for the file and some 
example entries. 

• /usr/share/doc/at-<version>/timespec contains more detailed information about the 
times that can be specified for cron jobs. 

• at man page — description of at and batch and their command line options. 
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Log Files 

Log files are files that contain messages about the system, including the kernel, services, and 
applications running on it. There are different log files for different information. For example, 
there is a default system log file, a log file just for security messages, and a log file for cron 
tasks. 

Log files can be very useful when trying to troubleshoot a problem with the system such as 
trying to load a kernel driver or when looking for unauthorized log in attempts to the system. 
This chapter discusses where to find log files, how to view log files, and what to look for in log 
files. 

Some log files are controlled by a daemon called sysiogd. A list of log messages maintained by 

sysiogd can be found in the /etc/sysiog.conf configuration file. 

1. Locating Log Files 

Most log files are located in the /var/iog/ directory. Some applications such as httpd and 
samba have a directory within /var/iog/ for their log files. 

You may notice multiple files in the log file directory with numbers after them. These are created 
when the log files are rotated. Log files are rotated so their file sizes do not become too large. 
The logrotate package contains a cron task that automatically rotates log files according to 
the /etc/iogrotate.conf configuration file and the configuration files in the 
/etc/iogrotate . d/ directory. By default, it is configured to rotate every week and keep four 
weeks worth of previous log files. 

2. Viewing Log Files 

Most log files are in plain text format. You can view them with any text editor such as v± or 
Emacs. Some log files are readable by all users on the system; however, root privileges are 
required to read most log files. 

To view system log files in an interactive, real-time application, use the Log Viewer. To start the 
application, go to Applications (the main menu on the panel) => System Tools => System 
Logs, or type the command system-iogviewer at a shell prompt. 

The application only displays log files that exist; thus, the list might differ from the one shown in 
Figure 35.1, "Log Viewer". 

To filter the contents of the log file for keywords, type the keyword(s) in the Filter for text field, 
and click Filter. Click Reset to reset the contents. 
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File Edit Help 



Boot Log 
Cron Log 

Kernel Startup Log 
Mail Log 

MySQL Server Log 
New 5 Log 



RPM Packages 



Security Log 
System Log 
Update Agent Log 
X.Org Xll Log 



RPM Packages 



This log file contains a list of RPM packages installed on 
the system. This list is updated daily by an automated cron 
task. 



4Suite-l.0-3.i386.rpm 

Canna-3.7p3-7.EL4.i386.rpm 

Canna-devel-3.7p3-7.EL4,i386.rpm 

Canna-libs-3.7p3-7.EL4.i386.rpm 

ElectricFence-2.2.2-19.i386,rpm 

FreeWnn-l.10pl020-5.i386.rpm 

FreeWnn-devel-l.10pl020-5.i386.rpm 

FreeWnn-libs-l,10pl020-5.i386.rpm 

GConf2-2.8.1-l.i386.rpm 

GConf2-devel-2.8.1-l.i386.rpm 

HelixPlayer-1.0.1,gold-8EL.i386.rpm 

lmageMagick-6.0,7.1-5.i386.rpm 

lrnageMagick-c++-6.0.7.1-5.i386,rpm 

lmageMagick-c++-devel-6.0.7.1-5.i386.rpm 

lrnageMagick-devel-6.0,7.1-5.i386.rpm 



* 



Filter for: 



^Filter 



i§* Reset 



Figure 35.1. Log Viewer 



By default, the currently viewable log file is refreshed every 30 seconds. To change the refresh 
rate, select Edit => Preferences from the pulldown menu. The window shown in Figure 35.2, 
"Log File Locations" appears. In the Log Files tab, click the up and down arrows beside the 
refresh rate to change it. Click Close to return to the main window. The refresh rate is changed 
immediately. To refresh the currently viewable file manually, select File => Refresh Now or 
press Ctrl-R. 

On the Log Files tab in the Preferences, the log file locations can be modified. Select the log 
file from the list, and click the Edit button. Type the new location of the log file or click the 
Browse button to locate the file location using a file selection dialog. Click OK to return to the 
preferences, and click Close to return to the main window. 
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Log Files; 
Log Files 



Alerts 



Warnings 



Configure The path and filename for each 
log file displayed 



Log File 


Location 




Boor Log 


/var/log/booLlog 




Cron Log 


/var/log/cron 




Kernel Startup Log 


/var/log/dmesg 




Mail Log 


/var/log/rnaillog 




MySQL Server Log /var/log/mysqldJog 




News Log 


/var/log/s pooler 




RFM Packages 


/var/log/rpmpkgs 





Add 



Edit 



Delete 



Refresh Rate 
Refresh log file every 



30 



seconds. 



X Close 



Figure 35.2. Log File Locations 



3. Adding a Log File 

To add a log file to the list, select Edit => Preferences, and click the Add button in the Log 
Files tab. 
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s-^s, Specify a new log file location. 


Name: 
Description: 
Location: 


Custom Log 


A description of my custom log 


/var/log/customJog 








U Cancel 


4 OK 





Figure 35.3. Adding a Log File 



Provide a name, description, and the location of the log file to add. After clicking OK, the file is 
immediately added to the viewing area, if the file exists. 

4. Examining Log Files 

Log Viewer can be configured to display an alert icon beside lines that contain key alert words 
and a warning icon beside lines that contain key warning words. 

To add alerts words, select Edit => Preferences from the pulldown menu, and click on the 
Alerts tab. Click the Add button to add an alert word. To delete an alert word, select the word 
from the list, and click Delete. 

The alert icon Q is displayed to the left of the lines that contains any of the alert words. 
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Log Files 



lAlertsi 



Warnings 



Alerts 



G 



fail 

denied 

rejected 

oops 

segfault 

segmentation 



Show alert icon for the following key 
words. 



Add 



Delete 



X close 



Figure 35.4. Alerts 



To add warning words, select Edit => Preferences from the pull-down menu, and click on the 
Warnings tab. Click the Add button to add a warning word. To delete a warning word, select 
the word from the list, and click Delete. 

The warning icon fj^ is displayed to the left of the lines that contains any of the warning words. 
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Log Files 



Alerts 



iWaminqsl 



Warnings 




Show warning icon for the following key 
words. 



warn 



Add 



Delete 



X close 



Figure 35.5. Warning 
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Manually Upgrading the Kernel 

The Red Hat Enterprise Linux kernel is custom built by the Red Hat kernel team to ensure its 
integrity and compatibility with supported hardware. Before Red Hat releases a kernel, it must 
first pass a rigorous set of quality assurance tests. 

Red Hat Enterprise Linux kernels are packaged in RPM format so that they are easy to upgrade 
and verify using the Red Hat Update Agent, or the up2date command. The Red Hat Update 
Agent automatically queries the Red Hat Network servers and determines which packages 
need to be updated on your machine, including the kernel. This chapter is only useful for those 
individuals that require manual updating of kernel packages, without using the up2date 
command. 



A 



Warning 

Please note, that building a custom kernel is not supported by the Red Hat 
Global Services Support team, and therefore is not explored in this manual. 



Use of up2date is highly recommended by Red Hat for installing upgraded 
kernels. 



For more information on Red Hat Network, the Red Hat Update Agent, and up2date, refer to 
Chapter 16, Red Hat Network. 



1 . Overview of Kernel Packages 



Red Hat Enterprise Linux contains the following kernel packages (some may not apply to your 
architecture): 



kernel — Contains the kernel and the following key features: 

• Uniprocessor support for x86 and Athlon systems (can be run on a multi-processor system, 
but only one processor is utilized) 

• Multi-processor support for all other architectures 

• For x86 systems, only the first 4 GB of RAM is used; use the kernei-hugemem package for 
x86 systems with over 4 GB of RAM 

kemei-devei — Contains the kernel headers and makefiles sufficient to build modules 
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against the kernel package. 

kernei-hugemem — (only for i686 systems) In addition to the options enabled for the kernel 
package, the key configuration options are as follows: 

• Support for more than 4 GB of RAM (up to 64 GB for x86) 




Note 



iei-hugemem is required for memory configurations higher than 16 GB. 



• PAE (Physical Address Extension) or 3 level paging on x86 processors that support PAE 

• Support for multiple processors 

• 4GB/4GB split — 4GB of virtual address space for the kernel and almost 4GB for each user 
process on x86 systems 

• kernei-hugemem-devei — Contains the kernel headers and makefiles sufficient to build 
modules against the kernei-hugemem package. 

• kemei-smp — Contains the kernel for multi-processor systems. The following are the key 
features: 

• Multi-processor support 

• Support for more than 4 GB of RAM (up to 16 GB for x86) 

• PAE (Physical Address Extension) or 3 level paging on x86 processors that support PAE 

• kemei-smp-devei — Contains the kernel headers and makefiles sufficient to build modules 
against the kemei-smp package. 

• kemei-utiis — Contains utilities that can be used to control the kernel or system hardware. 

• kemei-doc — Contains documentation files from the kernel source. Various portions of the 
Linux kernel and the device drivers shipped with it are documented in these files. Installation 
of this package provides a reference to the options that can be passed to Linux kernel 
modules at load time. 

By default, these files are placed in the /usr/share/doc/kemei-doc-<version>/ directory. 




Note 



The kernel-source package has been removed and replaced with an RPM that 
can only be retrieved from Red Hat Network. This * . src . rpm must then be 
rebuilt locally using the rpmbuiid command. Refer to the latest distribution 
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Release Notes, including all updates, at 

https://www.redhat.com/docs/manuals/enterprise/for more information on 
obtaining and installing the kernel source package. 



2. Preparing to Upgrade 

Before upgrading the kernel, take a few precautionary steps. The first step is to make sure 
working boot media exists for the system in case a problem occurs. If the boot loader is not 
configured properly to boot the new kernel, the system cannot be booted into Red Hat 
Enterprise Linux without working boot media. 

For example, to create a boot diskette, login as root, and type the following command at a shell 
prompt: 

/sbin/mkbootdisk 1 uname -r~ 



Tip 

Refer to the mkbootdisk man page for more options. Creating bootable media 
via CD-Rs, CD-RWs, and USB flash drives are also supported given the system 
BIOS also supports it. 



Reboot the machine with the boot media and verify that it works before continuing. 

Hopefully, the media is not needed, but store it in a safe place just in case. 

To determine which kernel packages are installed, execute the following command at a shell 
prompt: 

rpm -qa I grep kernel 

The output contains some or all of the following packages, depending on the system's 
architecture (the version numbers and packages may differ): 

kernel-2 . 6 . 9—5 . EL kernel-devel-2 . 6 . 9—5 . EL kernel-utils-2 . 6 . 9-5 .EL 
kernel -doc- 2 . 6 . 9-5 . EL kernel-smp-2 . 6 . 9-5 . EL kernel- smp-devel-2 . 6 . 9-5 . EL 
kernel-hugemem-devel-2 .6.9-5. EL 

From the output, determine which packages need to be download for the kernel upgrade. For a 
single processor system, the only required package is the kernel package. Refer to Section 1, 
"Overview of Kernel Packages" for descriptions of the different packages. 
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In the file name, each kernel package contains the architecture for which the package was built. 

The format is Wemel- <variant>-<version>. <arch>. rpm, Where <variant> is smp, utils, Or SO 

forth. The <arch> is one of the following: 

• x8 6_64 for the AMD64 architecture 

• ia64 for the IntelOltanium™ architecture 

• ppc64 for the IBM®eServer™pSeries™ architecture 

• ppc64 for the IBM®eServer™iSeries™ architecture 

• s390 for the IBM®S/390® architecture 

• s390x for the IBM®eServer™zSeries® architecture 

• x86 variant: The x86 kernels are optimized for different x86 versions. The options are as 
follows: 

• 1686 for lntel®Pentium® II, lntel®Pentium® III, lntel®Pentium® 4, AMD Athlon®, and AMD 
Duron® systems 

3. Downloading the Upgraded Kernel 

There are several ways to determine if an updated kernel is available for the system. 



• Security Errata — Go to the following location for information on security errata, including 
kernel upgrades that fix security issues: 

http: //www. redhat . com/ apps/ support /errata/ 

• Via Quarterly Updates — Refer to the following location for details: 

http : //www. redhat . com/ apps/ support / errata/ rhlas_er rata policy . html 

• Via Red Hat Network — Download and install the kernel RPM packages. Red Hat Network 
can download the latest kernel, upgrade the kernel on the system, create an initial RAM disk 
image if needed, and configure the boot loader to boot the new kernel. For more information, 
refer to http://www.redhat.com/docs/manuals/RHNetwork/ 
[http://www.redhat.com/docs/manuals/RHNetwork/]. 

If Red Hat Network was used to download and install the updated kernel, follow the instructions 
in Section 5, "Verifying the Initial RAM Disk Image" and Section 6, "Verifying the Boot Loader", 
only do not change the kernel to boot by default. Red Hat Network automatically changes the 
default kernel to the latest version. To install the kernel manually, continue to Section 4, 
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"Performing the Upgrade". 

4. Performing the Upgrade 

After retrieving all of the necessary packages, it is time to upgrade the existing kernel. At a shell 
prompt, as root, change to the directory that contains the kernel RPM packages and follow 
these steps. 




Important 

It is strongly recommended that the old kernel is kept in case there are problems 
with the new kernel. 



Use the -i argument with the rpm command to keep the old kernel. Do not use the -u option, 
since it overwrites the currently installed kernel, which creates boot loader problems. Issue the 
following command (the kernel version may vary): 



rpm -ivh kernel-2 . 6 . 9-5 . EL . <arch> . rpm 



If the system is a multi-processor system, install the kernei-smp packages as well (the kernel 
version may vary): 



rpm -ivh kernel-smp-2 . 6 . 9-5 . EL . <arch> . rpm 



If the system is 1686-based and contains more than 4 GB of RAM, install the kernei-hugemem 
package built for the ±686 architecture as well (the kernel version might vary): 



rpm -ivh kernel-hugemem-2 . 6 . 9-5 . EL . i 68 6 . rpm 



The next step is to verify that the initial RAM disk image has been created. Refer to Section 5, 
"Verifying the Initial RAM Disk Image" tor details. 

5. Verifying the Initial RAM Disk Image 

If the system uses the ext3 file system, a SCSI controller, or uses labels to reference partitions 
in /etc/fstab, an initial RAM disk is needed. The initial RAM disk allows a modular kernel to 
have access to modules that it might need to boot from before the kernel has access to the 
device where the modules normally reside. 

On the Red Hat Enterprise Linux architectures other than IBM eServer iSeries, the initial RAM 
disk can be created with the mkinitrd command. However, this step is performed automatically 
if the kernel and its associated packages are installed or upgraded from the RPM packages 
distributed by Red Hat, Inc.; thus, it does not need to be executed manually. To verify that it was 
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created, use the command is -1 /boot to make sure the initrd-<version>. img file was 
created (the version should match the version of the kernel just installed). 

On iSeries systems, the initial RAM disk file and vmlinux file are combined into one file, which 
is created with the addRamDisk command. This step is performed automatically if the kernel and 
its associated packages are installed or upgraded from the RPM packages distributed by Red 
Hat, Inc.; thus, it does not need to be executed manually. To verify that it was created, use the 
command is -1 /boot to make sure the /boot/vmiinitrd-<fcerriei-version> file was 
created (the version should match the version of the kernel just installed). 

The next step is to verify that the boot loader has been configured to boot the new kernel. Refer 
to Section 6, "Verifying the Boot Loader" tor details. 

6. Verifying the Boot Loader 

The kernel RPM package configures the boot loader to boot the newly installed kernel (except 
for IBM eServer iSeries systems). However, it does not configure the boot loader to boot the 
new kernel by default. 

It is always a good idea to confirm that the boot loader has been configured correctly. This is a 
crucial step. If the boot loader is configured incorrectly, the system does not boot into Red Hat 
Enterprise Linux properly. If this happens, boot the system with the boot media created earlier 
and try configuring the boot loader again. 

6.1. x86 Systems 

All x86 systems use GRUB as the boot loader, which includes all AMD64 systems. 

6.1.1. GRUB 

Confirm that the file /boot/grub/grub . conf contains a title section with the same version as 
the kernel package just installed (if the kernei-smp or kernei-hugemem package was 
installed, a section exists for it as well): 



# Note that you do not have to rerun grub after making 


changes 


to this file 


# NOTICE: You have a /boot partition. This means that 






# all kernel and initrd paths are relative to 


/boot / , 


eg. 


# root (hdO,0) 






# kernel /vmlinuz-version ro root=/dev/hda2 






# initrd /initrd-version . img 






#boot=/dev/hda 






default=l 






timeout=l 






splashimage= (hdO , ) / grub/ splash . xpm . gz 






title Red Hat Enterprise Linux (2. 6. 9-5. EL) 






root (hdO,0) 






kernel /vmlinuz-2 . 6 . 9-5 . EL ro root=LABEL=/ 






initrd /initrd-2 . 6 . 9-5 . EL . img 






title Red Hat Enterprise Linux (2 . 6 . 9-1 . 906_EL) 






root (hdO,0) 






kernel /vmlinuz-2 . 6 . 9-1 . 906_EL ro root=LABEL=/ 
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initrd /initrd-2 . 6 . 9-1 . 906_EL. img 

If a separate /boot/ partition was created, the paths to the kernel and initrd image are relative 

to /boot/. 

Notice that the default is not set to the new kernel. To configure GRUB to boot the new kernel 
by default, change the value of the default variable to the title section number for the title 
section that contains the new kernel. The count starts with 0. For example, if the new kernel is 
the first title section, set default to o. 

Begin testing the new kernel by rebooting the computer and watching the messages to ensure 
that the hardware is detected properly. 

6.2. Itanium Systems 



Itanium systems use ELILO as the boot loader, which uses 

/boot/efi/EFi/redhat/eiiio.conf as the configuration file. Confirm that this file contains an 
image section with the same version as the kernel package just installed: 



prompt 




timeout=50 




def ault=old 




image=vmlinuz-2 .6.9-5. EL 




label=linux 




initrd=initrd-2 . 6 . 9-5 . 


. EL . img 


read-only 




append="root=LABEL=/" 




image=vmlinuz-2 . 6 . 9-1 . 906_EL 




label=old 




initrd=initrd-2 . 6 . 9-1 . 


.90 6. img 


read-only 




append="root=LABEL=/" 





Notice that the default is not set to the new kernel. To configure ELILO to boot the new kernel, 
change the value of the default variable to the value of the label for the image section that 
contains the new kernel. 

Begin testing the new kernel by rebooting the computer and watching the messages to ensure 
that the hardware is detected properly. 

6.3. IBM S/390 and IBM eServer zSeries Systems 

The IBM S/390 and IBM eServer zSeries systems use z/IPL as the boot loader, which uses 
/etc/zipi.conf as the configuration file. Confirm that the file contains a section with the same 
version as the kernel package just installed: 
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[def aultboot ] 
def ault=old 
target=/boot / 

[linux] 

image=/boot/vmlinuz-2 . 6 . 9-5 . EL 
ramdisk=/boot/ initrd-2 . 6 . 9-5 .EL. img 
parameters="root=LABEL=/" 

[old] 

image=/boot/vmlinuz-2 . 6 . 9-1 . 906_EL 
ramdisk=/boot / initrd-2. 6. 9-1. 90 6_EL . img 
parameters="root=LABEL=/" 

Notice that the default is not set to the new kernel. To configure z/IPL to boot the new kernel by 
default change the value of the default variable to the name of the section that contains the 
new kernel. The first line of each section contains the name in brackets. 

After modifying the configuration file, run the following command as root to enable the changes: 

/ sbin/ zipl 



Begin testing the new kernel by rebooting the computer and watching the messages to ensure 
that the hardware is detected properly. 

6.4. IBM eServer iSeries Systems 

The /boot/vmiinitrd-<icernei-'i/ersion> file is installed when you upgrade the kernel. 
However, you must use the dd command to configure the system to boot the new kernel: 



1 . As root, issue the command cat /proc/iseries/mf /side to determine the default side 
(either A, B, orC). 

2. As root, issue the following command, where <kernei-version> is the version of the new 
kernel and <side> is the side from the previous command: 

dd if=/boot/vmlinitrd-<A:ernel-versior!> of=/proc/iSeries/mf / <side>/vmlinux 

bs=8k 



Begin testing the new kernel by rebooting the computer and watching the messages to ensure 
that the hardware is detected properly. 

6.5. IBM eServer pSeries Systems 

IBM eServer pSeries systems use YABOOT as the boot loader, which uses /etc/aboot . conf 
as the configuration file. Confirm that the file contains an image section with the same version 
as the kernel package just installed: 
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boot=/ dev/ sdal 

init-message=Welcome to Red Hat Enterprise Linux! 
Hit <TAB> for boot options 

partition=2 
timeout=30 

install=/usr/lib/yaboot/yaboot 

delay=10 

nonvram 

image=/vmlinux — 2 .6.9-5. EL 
label=old 
read-only 

initrd=/ initrd — 2. 6. 9-5. EL. img 
append="root=LABEL=/" 

image=/vmlinux-2 . 6 . 9-5 . EL 
label=linux 
read-only 

initrd=/ initrd-2 . 6 . 9-5 . EL . img 
append="root=LABEL=/" 



Notice that the default is not set to the new kernel. The kernel in the first image is booted by 
default. To change the default kernel to boot either move its image stanza so that it is the first 
one listed or add the directive default and set it to the label of the image stanza that contains 
the new kernel. 

Begin testing the new kernel by rebooting the computer and watching the messages to ensure 
that the hardware is detected properly. 
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Kernel Modules 

The Linux kernel has a modular design. At boot time, only a minimal resident kernel is loaded 
into memory. Thereafter, whenever a user requests a feature that is not present in the resident 
kernel, a kernel module, sometimes referred to as a driver, is dynamically loaded into memory. 

During installation, the hardware on the system is probed. Based on this probing and the 
information provided by the user, the installation program decides which modules need to be 
loaded at boot time. The installation program sets up the dynamic loading mechanism to work 
transparently. 

If new hardware is added after installation and the hardware requires a kernel module, the 
system must be configured to load the proper kernel module for the new hardware. When the 
system is booted with the new hardware, the Kudzu program runs, detects the new hardware if 
it is supported, and configures the module for it. The module can also be specified manually by 
editing the module configuration file, /etc/modprobe . conf. 



Note 

Video card modules used to display the X Window System interface are part of 
the xorg-xii packages, not the kernel; thus, this chapter does not apply to 
them. 



For example, if a system included an SMC EtherPower 10 PCI network adapter, the module 
configuration file contains the following line: 

alias ethO tulip 

If a second network card is added to the system and is identical to the first card, add the 

following line tO /etc/modprobe . conf: 
alias ethl tulip 

Refer to the Red Hat Enterprise Linux Reference Guide for an alphabetical list of kernel 
modules and supported hardware for those modules. 

1. Kernel Module Utilities 

A group of commands for managing kernel modules is available if the moduie-init-toois 
package is installed. Use these commands to determine if a module has been loaded 
successfully or when trying different modules for a piece of new hardware. 

The command /sbin/ismod displays a list of currently loaded modules. For example: 
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Module 


Size 


Used by 




nf s 


218437 


1 






lockd 


63977 


2 


nf s 




parport_pc 


24705 


1 






lp 


12077 









parport 


37129 


2 


parport_pc, lp 




autof s4 


23237 


2 






i2c_dev 


11329 









i2c_core 


22081 


1 


i2c_dev 




sunrpc 


157093 


5 


nf s , lockd 




button 


6481 









battery 


8901 









ac 


4805 









md5 


4033 


1 






ipv6 


232833 


16 




ohci_hcd 


21713 









elOO 


39493 









mii 


4673 


1 


elOO 




floppy 


58481 









sg 


33377 









dm_s nap shot 


17029 









dm_zero 


2369 









dm mirror 


22 957 


2 






ext3 


116809 


2 






jbd 


71257 


1 


ext3 




dm_mod 


54741 


6 


dm_snapshot, dm_ 


.zero, dm_mirror 


ips 


46173 


2 






aic7xxx 


148121 









sd_mod 


17217 


3 






scsi_mod 


121421 


4 


sg, ips, aic7xxx, 


sd_mod 



For each line, the first column is the name of the module, the second column is the size of the 
module, and the third column is the use count. 

The /sbin/ismod output is less verbose and easier to read than the output from viewing 

/proc/modules. 

To load a kernel module, use the /sbin/modprobe command followed by the kernel module 
name. By default, modprobe attempts to load the module from the 

/iib/moduies/<icernei-version>/kernei/drivers/ subdirectories. There is a subdirectory 
for each type of module, such as the net / subdirectory for network interface drivers. Some 
kernel modules have module dependencies, meaning that other modules must be loaded first 
for it to load. The /sbin/modprobe command checks for these dependencies and loads the 
module dependencies before loading the specified module. 

For example, the command 

/sbin/modprobe elOO 

loads any module dependencies and then the eioo module. 
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To print to the screen all commands as /sbin/modprobe executes them, use the -v option. For 
example: 

/sbin/modprobe -v elOO 

Output similar to the following is displayed: 

/ sbin/insmod / 1 ib /module s / 2.6.9-5.EL/kernel/drivers/net/el00.ko Using 
/lib/modules/2 . 6 . 9-5 . EL/kernel/drivers/net /el 00 . ko Symbol version prefix 
1 smp_ ' 

The /sbin/insmod command also exists to load kernel modules; however, it does not resolve 
dependencies. Thus, it is recommended that the /sbin/modprobe command be used. 

To unload kernel modules, use the /sbin/rmmod command followed by the module name. The 
rmmod utility only unloads modules that are not in use and that are not a dependency of other 
modules in use. 

For example, the command 

/sbin/rmmod elOO 

unloads the eioo kernel module. 

Another useful kernel module utility is modinfo. Use the command /sbin/modinfo to display 
information about a kernel module. The general syntax is: 

/sbin/modinfo [options ] <module> 

Options include -d, which displays a brief description of the module, and -p, which lists the 
parameters the module supports. For a complete list of options, refer to the modinfo man page 

(man modinfo). 

2. Persistent Module Loading 

Kernel modules are usually loaded directly by the facility that requires them, which is given 
correct settings in the /etc/modprobe . conf file. However, it is sometimes necessary to 
explicitly force the loading of a module at boot time. 

Red Hat Enterprise Linux checks for the existence of the /etc/rc .modules file at boot time, 
which contains various commands to load modules. The rc. modules should be used, and 
nofrc. local because rc. modules is executed earlier in the boot process. 

For example, the following commands configure loading of the f oo module at boot time (as 
root): 



373 



Chapter 37. Kernel Modules 



# echo modprobe foo >> /etc/rc . modules 

# chmod +x /etc/rc . modules 



Tip 

This approach is not necessary for network and SCSI interfaces because they 
have their own specific mechanisms. 



3. Additional Resources 

For more information on kernel modules and their utilities, refer to the following resources. 

3.1. Installed Documentation 

• ismod man page — description and explanation of its output. 

• insmod man page — description and list of command line options. 

• modprobe man page — description and list of command line options. 

• rmmod man page — description and list of command line options. 

• modinf o man page — description and list of command line options. 

• /usr/share/ doc/ kernel -doc- <versi on>/Docuraent at ion/kbuild/modules . txt — how to 

compile and use kernel modules. 

3.2. Useful Websites 

• http://www.redhat.com/mirrors/LDP/HOWTO/Module-HOWTO/index.html — Linux Loadable 
Kernel Module HOWTO from the Linux Documentation Project. 
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Mail Transport Agent (MTA) 
Configuration 

A Mail Transport Agent {Ml A) is essential for sending email. A Mail User Agent (MUA) such as 
Evolution, Mozilla Mail, Thunderbird, and Mutt, is used to read and compose email. When a 
user sends an email from an MUA, the message is handed off to the MTA, which sends the 
message through a series of MTAs until it reaches its destination. 

Even if a user does not plan to send email from the system, some automated tasks or system 
programs might use the /bin/mail command to send email containing log messages to the 
root user of the local system. 

Red Hat Enterprise Linux 5.0.0 provides three MTAs: Sendmail, Postfix, and Exim. If all three 
are installed, sendmail is the default MTA. The Mail Transport Agent Switcher allows for the 
selection of either sendmail, postfix, or exim as the default MTA for the system. 

The system-switch-maii RPM package must be installed to use the text-based version of the 
Mail Transport Agent Switcher program. If you want to use the graphical version, the 

system-switch-maii-gnome package must also be installed. 

To start the Mail Transport Agent Switcher, select Applications (the main menu on the panel) 
=> Preferences => More Preferences => Mail Transport Agent Switcher, or type the 
command system-switch-maii at a shell prompt (for example, in an XTerm or GNOME 
terminal). 

The program automatically detects if the X Window System is running. If it is running, the 
program starts in graphical mode as shown in Figure 38.1, "Mail Transport Agent Switcher". If 
X is not detected, it starts in text-mode. To force Mail Transport Agent Switcher to run in 

text-mode, use the command system-switch -mail-nox. 



375 



Chapter 38. Mail Transport Ag.. 




The Mail Transport Agent Switcher is a tool which enables 
users to easily switch between various Mail Transport Agent 
that they have installed. 

Please choose your Mail transport agent. 



Available Mail Transport Agent 

® Sendrnail 
O Eostfix 
O £xim 



Cancel 



$ OK 



Figure 38.1. Mail Transport Agent Switcher 



If you select OK to change the MTA, the selected mail daemon is enabled to start at boot time, 
and the unselected mail daemons are disabled so that they do not start at boot time. The 
selected mail daemon is started, and any other mail daemon is stopped; thus making the 
changes take place immediately. 

For more information about email protocols and MTAs, refer to the Red Hat Enterprise Linux 
Reference Guide. 
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Part VI. System Monitoring 

System administrators also monitor system performance. Red Hat Enterprise Linux contains 
tools to assist administrators with these tasks. 



Chapter 39. 



Gathering System Information 

Before you learn how to configure your system, you should learn how to gather essential system 
information. For example, you should know how to find the amount of free memory, the amount 
of available hard drive space, how your hard drive is partitioned, and what processes are 
running. This chapter discusses how to retrieve this type of information from your Red Hat 
Enterprise Linux system using simple commands and a few simple programs. 

1 . System Processes 

The ps ax command displays a list of current system processes, including processes owned by 
other users. To display the owner alongside each process, use the ps aux command. This list 
is a static list; in other words, it is a snapshot of what was running when you invoked the 
command. If you want a constantly updated list of running processes, use top as described 
below. 

The ps output can be long. To prevent it from scrolling off the screen, you can pipe it through 
less: 

ps aux | less 

You can use the ps command in combination with the grep command to see if a process is 
running. For example, to determine if Emacs is running, use the following command: 

ps ax | grep emacs 

The top command displays currently running processes and important information about them 
including their memory and CPU usage. The list is both real-time and interactive. An example of 
output from the top command is provided as follows: 

top - 15:02:46 up 35 min, 4 users, load average: 0.17, 0.65, 1.00 Tasks: 
110 total, 1 running, 107 sleeping, stopped, 2 zombie Cpu(s) : 41.1% us, 
2.0% sy, 0.0% ni, 56.6% id, 0.0% wa, 0.3% hi, 0.0% si Mem: 775024k total, 
772028k used, 2996k free, 68468k buffers Swap: 1048568k total, 176k used, 
1048392k free, 441172k cached PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ 
COMMAND 4624 root 15 40192 18m 7228 S 28.4 2.4 1:23.21 X 4926 mhideo 15 
55564 33m 9784 S 13.5 4.4 0:25.96 gnome-terminal 6475 mhideo 16 3612 968 
760 R 0.7 0.1 0:00.11 top 4920 mhideo 15 20872 10m 7808 S 0.3 1.4 0:01.61 
wnck-applet 1 root 16 1732 548 472 S 0.0 0.1 0:00.23 init 2 root 34 19 
S 0.0 0.0 0:00.00 ksoftirqd/0 3 root 5 -10 S 0.0 0.0 0:00.03 
events/0 4 root 6 -10 S 0.0 0.0 0:00.02 khelper 5 root 5 -10 S 
0.0 0.0 0:00.00 kacpid 29 root 5 -10 S 0.0 0.0 0:00.00 kblockd/0 47 
root 16 S 0.0 0.0 0:01.74 pdflush 50 root 11 -10 S 0.0 0.0 
0:00.00 aio/0 30 root 15 S 0.0 0.0 0:00.05 khubd 49 root 16 
S 0.0 0.0 0:01.44 kswapdO 

To exit top, press the q key. 
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Table 39. 1, "Interactive top commands" contains useful interactive commands that you can use 
with top. For more information, refer to the top(1) manual page. 



Command 


Description 


Space 


Immediately refresh the display 


h 


Display a help screen 


k 


Kill a process. You are prompted for the 
process ID and the signal to send to it. 


n 


Change the number of processes displayed. 
You are prompted to enter the number. 


u 


Sort by user. 


M 


Sort by memory usage. 


P 


Sort by CPU usage. 



Table 39.1. Interactive top commands 



If you prefer a graphical interface for top, you can use the GNOME System Monitor. To start it 
from the desktop, select System => Administration => System Monitor or type 
gnome-system-monitor at a shell prompt (such as an XTerm). Select the Process Listing tab. 

The GNOME System Monitor allows you to search for a process in the list of running 
processes. Using the Gnome System Monitor, you can also view all processes, your processes, 
or active processes. 

The Edit menu item allows you to: 

• Stop a process. 

• Continue or start a process. 

• End a processes. 

• Kill a process. 

• Change the priority of a selected process. 

• Edit the System Monitor preferences. These include changing the interval seconds to refresh 
the list and selecting process fields to display in the System Monitor window. 

The View menu item allows you to: 

• View only active processes. 
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• View all processes. 

• View my processes. 

• View process dependencies. 

• Hide a process. 

• View hidden processes. 

• View memory maps. 

• View the files opened by the selected process. 

To stop a process, select it and click End Process. Alternatively you can also stop a process by 
selecting it, clicking Edit on your menu and selecting Stop Process. 

To sort the information by a specific column, click on the name of the column. This sorts the 
information by the selected column in ascending order. Click on the name of the column again 
to toggle the sort between ascending and descending order. 



File Edit View Help 



Process Listing 
Search: 



Resource Monitor 



View: 



My Processes 



Process Name v 


User 


Memory 


X Server Memory 


Nice 


ID 




^ -bash 


andriusb 


4.9 MB 


bytes 





18245 




^ sh 


andriusb 


5.3 MB 


bytes 





18279 




v xinit 


andriusb 


2.7 MB 


bytes 





18292 




$5 gnome-session 


andriusb 


20.3 MB 


bytes 





18322 




bonobo-activation-server 


andriusb 


8.3 MB 


bytes 





18358 




clock-applet 


andriusb 


20.4 MB 


bytes 





18436 




dbus-daemon-1 


andriusb 


14.0 MB 


bytes 





18348 


dbus-launch 


andriusb 


4.3 MB 


bytes 





18347 




eggcups 


andriusb 


39.9 MB 


bytes 





18410 




gam_server 


andriusb 


3.0 MB 


bytes 





18366 




gconfd-2 


andriusb 


12.0 MB 


bytes 





18353 




gnome-keyring-daemon 


andriusb 


3.3 MB 


bytes 





18356 




gnome-keyring-daemon 


andriusb 


3.9 MB 


bytes 





3434 




ti gnome-panel 


andriusb 


24.4 MB 


401 K 





18404 




gnome-settings-daemon 


andriusb 


19.4 MB 


bytes 





18360 




■ gnome-system-monitor 


andriusb 


23.1 MB 


1.4 MB 





18440 




gnome-vfs-daemon 


andriusb 


21.0 MB 


bytes 





18421 




gnome-volume-manager 


andriusb 


19.0 MB 


bytes 





184 8 




mapping-daemon 


andriusb 


2.9 MB 


bytes 





18429 




metacity 


andriusb 


14.4 MB 


bytes 





18399 





More Jnfo 



End Process 
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Figure 39.1. GNOME System Monitor 

2. Memory Usage 

The free command displays the total amount of physical memory and swap space for the 
system as well as the amount of memory that is used, free, shared, in kernel buffers, and 
cached. 

total used free shared buffers cached Mem: 645712 549720 95992 176248 
224452 -/+ buffers/cache: 149020 496692 Swap: 1310712 1310712 

The command f ree -m shows the same information in megabytes, which are easier to read. 

total used free shared buffers cached Mem: 630 536 93 172 219 -/+ 
buffers/cache: 145 485 Swap: 1279 1279 

If you prefer a graphical interface for free, you can use the GNOME System Monitor. To start 
it from the desktop, go to System => Administration => System Monitor or type 
gnome-system-monitor at a shell prompt (such as an XTerm). Click on the Resources tab. 
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File Edit View Help 



Process Listing 



Resource Monitor! 



CPU History 



n ■«■ wm 


mm mm 


1111 


■ HI 










■Ml 




mmwmm 


■Him 

SiHB 




■ CPUl: 16.0% 



Memory and Swap History 




Used memory: 203 MB of 631 MB 
Used swap: bytes of 1.2 GB 



Devices 



Name 


Directory 


Type 


Total 


Used 




/dev/sdal 


/boot 


eKt3 


98.3 MB 


9.1MB | 


9 % 






q^j none 


/dev/shm 


tmpfs 


315 MB 


bytes | 


% 






/dev/mapper/VolGroupOO-LogVolOO 


1 


ext3 


11.1 GB 


G.O GB | 









Figure 39.2. GNOME System Monitor - Resources tab 



3. File Systems 

The df command reports the system's disk space usage. If you type the command df at a shell 
prompt, the output looks similar to the following: 



Filesystem lK-blocks Used Available Use% Mounted on 
/dev/mapper/VolGroupOO-LogVolOO 11675568 6272120 4810348 57% / /dev/sdal 
100691 9281 86211 10% /boot none 322856 322856 0% /dev/shm 



By default, this utility shows the partition size in 1 kilobyte blocks and the amount of used and 
available disk space in kilobytes. To view the information in megabytes and gigabytes, use the 
command df -h. The -h argument stands for human-readable format. The output looks similar 
to the following: 
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Filesystem Size Used Avail Use% Mounted on /dev/mapper/VolGroupOO-LogVolOO 
12G 6.0G 4.6G 57% / /dev/sdal 99M 9 . 1M 85M 10% /boot none 316M 316M 0% 
/dev/ shm 

In the list of mounted partitions, there is an entry for /dev/ shm. This entry represents the 
system's virtual memory file system. 

The du command displays the estimated amount of space being used by files in a directory. If 
you type du at a shell prompt, the disk usage for each of the subdirectories is displayed in a list. 
The grand total for the current directory and subdirectories are also shown as the last line in the 
list. If you do not want to see the totals for all the subdirectories, use the command du -hs to 
see only the grand total for the directory in human-readable format. Use the du — help 
command to see more options. 

To view the system's partitions and disk space usage in a graphical format, use the Gnome 
System Monitor by clicking on System => Administration => System Monitor or type 
gnome-system-mon itor at a shell prompt (such as an XTerm). Select the File Systems tab to 
view the system's partitions. The figure below illustrates the File Systems tab. 

Figure 39.3. GNOME System Monitor - File Systems 

4. Hardware 

If you are having trouble configuring your hardware or just want to know what hardware is in 
your system, you can use the Hardware Browser application to display the hardware that can 
be probed. To start the program from the desktop, select System (the main menu on the panel) 
=> Administration => Hardware or type hwbrowser at a shell prompt. As shown in Figure 39.4, 
"Hardware Browser ", it displays your CD-ROM devices, diskette drives, hard drives and their 
partitions, network devices, pointing devices, system devices, and video cards. Click on the 
category name in the left menu, and the information is displayed. 



384 



Hardware 



File 



CD-ROM Drives 



Floppy Disks 
Hard Drives 
Keyboards 
Network devices 
Pointing devices 
RAID devices 
SCSI devices 
System devices 
USB devices 
Video cards 



Selected Device 



LG CD-ROM CRD-8484B 



Device Information 

Manufacturer: LG 

Driver: none or built-in 

Device: /dev/hda 



Figure 39.4. Hardware Browser 



The Device Manager application can also be used to display your system hardware. This 
application can be started by selecting System (the main menu on the panel) => 
Administration => Hardware like the Hardware Browser. To start the application from a 
terminal, type hai-device-manager. Depending on your installation preferences, the graphical 
menu above may start this application or the Hardware Browser when clicked. The figure 
below illustrates the Device Manager window. 



Figure 39.5. Device Manager 



You can also use the ispoi command to list all PCI devices. Use the command ispci -v for 
more verbose information or ispci -w for very verbose output. 

For example, ispci can be used to determine the manufacturer, model, and memory size of a 
system's video card: 

00:00.0 Host bridge: ServerWorks CNB2 OLE Host Bridge (rev 06) 00:00.1 Host 
bridge: ServerWorks CNB20LE Host Bridge (rev 06) 00:01.0 VGA compatible 
controller: S3 Inc. Savage 4 (rev 04) 00:02.0 Ethernet controller: Intel 
Corp. 82557/8/9 [Ethernet Pro 100] (rev 08) 00:Of.O ISA bridge: ServerWorks 
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0SB4 South Bridge (rev 50) 00:0f.l IDE interface: ServerWorks OSB4 IDE 
Controller 00:0f.2 USB Controller: ServerWorks OSB4/CSB5 OHCI USB Controller 
(rev 04) 01:03.0 SCSI storage controller: Adaptec AIC-7892P U160/m (rev 02) 
01:05.0 RAID bus controller: IBM ServeRAID Controller 



The ispci is also useful to determine the network card in your system if you do not know the 
manufacturer or model number. 

5. Additional Resources 

To learn more about gathering system information, refer to the following resources. 

5.1. Installed Documentation 



• ps --help — Displays a list of options that can be used with ps. 

• top manual page — Type man top to learn more about top and its many options. 

• free manual page — type man free to learn more about free and its many options. 

• df manual page — Type man df to learn more about the df command and its many options. 

• du manual page — Type man du to learn more about the du command and its many options. 

• ispci manual page — Type man ispci to learn more about the ispci command and its 
many options. 

• /proc/ directory — The contents of the /proc/ directory can also be used to gather more 
detailed system information. 
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OProfile 

OProfile is a low overhead, system-wide performance monitoring tool. It uses the performance 
monitoring hardware on the processor to retrieve information about the kernel and executables 
on the system, such as when memory is referenced, the number of L2 cache requests, and the 
number of hardware interrupts received. On a Red Hat Enterprise Linux system, the oprof He 
RPM package must be installed to use this tool. 

Many processors include dedicated performance monitoring hardware. This hardware makes it 
possible to detect when certain events happen (such as the requested data not being in cache). 
The hardware normally takes the form of one or more counters that are incremented each time 
an event takes place. When the counter value, essentially rolls over, an interrupt is generated, 
making it possible to control the amount of detail (and therefore, overhead) produced by 
performance monitoring. 

OProfile uses this hardware (or a timer-based substitute in cases where performance monitoring 
hardware is not present) to collect samples of performance-related data each time a counter 
generates an interrupt. These samples are periodically written out to disk; later, the data 
contained in these samples can then be used to generate reports on system-level and 
application-level performance. 

OProfile is a useful tool, but be aware of some limitations when using it: 



• Use of shared libraries — Samples for code in shared libraries are not attributed to the 
particular application unless the — separate=iibrary option is used. 

• Performance monitoring samples are inexact — When a performance monitoring register 
triggers a sample, the interrupt handling is not precise like a divide by zero exception. Due to 
the out-of-order execution of instructions by the processor, the sample may be recorded on a 
nearby instruction. 

• opreport does not associate samples for inline functions' properly — opreport uses a 
simple address range mechanism to determine which function an address is in. Inline function 
samples are not attributed to the inline function but rather to the function the inline function 
was inserted into. 

• OProfile accumulates data from multiple runs — OProfile is a system-wide profiler and 
expects processes to start up and shut down multiple times. Thus, samples from multiple runs 
accumulate. Use the command opcontroi — reset to clear out the samples from previous 
runs. 

• Non-CPU-limited performance problems — OProfile is oriented to finding problems with 
CPU-limited processes. OProfile does not identify processes that are asleep because they 
are waiting on locks or for some other event to occur (for example an I/O device to finish an 
operation). 
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1 . Overview of Tools 



Table 40. 1, "OProfile Commands" provides a brief overview of the tools provided with the 
oprof iie package. 



Command 


Description 


op_help 


Displays available events for the system's processor along with a 
brief description of each. 


op_import 


Converts sample database files from a foreign binary format to the 
native format for the system. Only use this option when analyzing 
a sample database from a different architecture. 


opannotate 


Creates annotated source for an executable if the application was 
compiled with debugging symbols. Refer to Section 5.3, "Using 

opannotate" ^OX details. 


opcontrol 


Configures what data is collected. Refer to Section 2, "Configuring 
OProfile" tor details. 


opreport 


Retrieves profile data. Refer to Section 5. 1, "Using opreport" for 
details. 


oprof iled 


Runs as a daemon to periodically write sample data to disk. 



Table 40.1. OProfile Commands 



2. Configuring OProfile 

Before OProfile can be run, it must be configured. At a minimum, selecting to monitor the kernel 
(or selecting not to monitor the kernel) is required. The following sections describe how to use 
the opcontrol utility to configure OProfile. As the opcontrol commands are executed, the 

Setup Options are Saved to the /root/ .oprof ile/daemonrc file. 

2.1. Specifying the Kernel 

First, configure whether OProfile should monitor the kernel. This is the only configuration option 
that is required before starting OProfile. All others are optional. 

To monitor the kernel, execute the following command as root: 

opcontrol — setup — vmlinux=/usr/lib/debug/lib/modules/ * uname -r" /vmlinux 
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Note 

V The debuginf o package must be installed (which contains the uncompressed 

kernel) in order to monitor the kernel. 



To configure OProfile not to monitor the kernel, execute the following command as root: 

opcontrol — setup — no-vmlinux 

This command also loads the oprof ile kernel module, if it is not already loaded, and creates 
the /dev/oprof iie/ directory, if it does not already exist. Refer to Section 6, "Understanding 
/dev/oprofiie/"\or details about this directory. 



Note 

Even if OProfile is configured not to profile the kernel, the SMP kernel still must 
be running so that the oprof iie module can be loaded from it. 



Setting whether samples should be collected within the kernel only changes what data is 
collected, not how or where the collected data is stored. To generate different sample files for 
the kernel and application libraries, refer to Section 2.3, "Separating Kernel and User-space 
Profiles". 

2.2. Setting Events to Monitor 



Most processors contain counters, which are used by OProfile to monitor specific events. As 
shown in Table 40.2, "OProfile Processors and Counters", the number of counters available 
depends on the processor. 



Processor 


cpu_type 


Number of Counters 


Pentium Pro 


i386/ppro 


2 


Pentium II 


i386/pii 


2 


Pentium III 


i386/piii 


2 


Pentium 4 (non-hyper-threaded) 


i386/p4 


8 


Pentium 4 (hyper-threaded) 


i386/p4-ht 


4 


Athlon 


i386/athlon 


4 


AMD64 


x86-64/hammer 


4 


Itanium 


ia64/itanium 


4 


Itanium 2 


ia64/itanium2 


4 
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Processor 


cpu_type 


Number of Counters 


TIMERJNT 


timer 


1 


IBM eServer iSeries and pSeries 


timer 


1 




ppc64/power4 


8 




ppc64/power5 


6 




ppc64/970 


8 


IBM eServer S/390 and S/390x 


timer 


1 


IBM eServer zSeries 


timer 


1 



Table 40.2. OProfile Processors and Counters 



Use Table 40.2, "OProfile Processors and Counters"to verify that the correct processor type 
was detected and to determine the number of events that can be monitored simultaneously, 
timer is used as the processor type if the processor does not have supported performance 
monitoring hardware. 

If timer is used, events cannot be set for any processor because the hardware does not have 
support for hardware performance counters. Instead, the timer interrupt is used for profiling. 

If timer is not used as the processor type, the events monitored can be changed, and counter 
for the processor is set to a time-based event by default. If more than one counter exists on the 
processor, the counters other than counter are not set to an event by default. The default 
events monitored are shown in Table 40.3, "Default Events". 



Processor 


Default Event for Counter 


Description 


Pentium Pro, Pentium 
II, Pentium III, Athlon, 
AMD64 


CPU_CLK_UNHALTED 


The processor's clock is not halted 


Pentium 4 (HT and 
non-HT) 


GLOBALPOWERE VENTS 


The time during which the processor 
is not stopped 


Itanium 2 


CPU_CYCLES 


CPU Cycles 


TIMERJNT 


(none) 


Sample for each timer interrupt 


ppc64/power4 


CYCLES 


Processor Cycles 


ppc64/power5 


CYCLES 


Processor Cycles 


ppc64/970 


CYCLES 


Processor Cycles 



Table 40.3. Default Events 



The number of events that can be monitored at one time is determined by the number of 
counters for the processor. However, it is not a one-to-one correlation; on some processors, 
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certain events must be mapped to specific counters. To determine the number of counters 
available, execute the following command: 



cat /dev/oprof ile/cpu_type 



The events available vary depending on the processor type. To determine the events available 
for profiling, execute the following command as root (the list is specific to the system's 
processor type): 

op_help 



The events for each counter can be configured via the command line or with a graphical 
interface. For more information on the graphical interface, refer to Section 8, "Graphical 
Interface". If the counter cannot be set to a specific event, an error message is displayed 

To set the event for each configurable counter via the command line, use opcontroi: 

opcontrol — event=<event -name> : <sample-rate> 



Replace <event-name> with the exact name of the event from op_heip, and replace 
<sampie-rate> with the number of events between samples. 

2.2.1. Sampling Rate 

By default, a time-based event set is selected. It creates a sample every 1 00,000 clock cycles 
per processor. If the timer interrupt is used, the timer is set to whatever the jiffy rate is and is not 
user-settable. If the cpu_type is not timer, each event can have a sampling rate set for it. The 
sampling rate is the number of events between each sample snapshot. 

When setting the event for the counter, a sample rate can also be specified: 

opcontrol — event=<erent-name>: <sample-rate> 



Replace <sampie-rate> with the number of events to wait before sampling again. The smaller 
the count, the more frequent the samples. For events that do not happen frequently, a lower 
count may be needed to capture the event instances. 



Caution 

Be extremely careful when setting sampling rates. Sampling too frequently can 
overload the system, causing the system to appear as if it is frozen or causing 
the system to actually freeze. 
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2.2.2. Unit Masks 

If the opu_type is not timer, unit masks may also be required to further define the event. 

Unit masks for each event are listed with the op_heip command. The values for each unit mask 
are listed in hexadecimal format. To specify more than one unit mask, the hexadecimal values 
must be combined using a bitwise or operation. 

opcontrol — event=<event-name>: <sampJe-rate>: <unit-mask> 

2.3. Separating Kernel and User-space Profiles 

By default, kernel mode and user mode information is gathered for each event. To configure 
OProfile not to count events in kernel mode for a specific counter, execute the following 
command: 

opcontrol — event=<event-name> : < sample- r at e> : <unit-mask> : 

Execute the following command to start profiling kernel mode for the counter again: 

opcontrol — event = <erent-i!aiiie> : < sample- r at e> : <unit-mask> : 1 

To configure OProfile not to count events in user mode for a specific counter, execute the 
following command: 

opcontrol — event=<event-name> : < sample- r at e> : <unit-mask> : <kernel> : 

Execute the following command to start profiling user mode for the counter again: 

opcontrol — event=<event-name> : < sample- r at e> : <unit-mask> : <kernel>: 1 

When the OProfile daemon writes the profile data to sample files, it can separate the kernel and 
library profile data into separate sample files. To configure how the daemon writes to sample 
files, execute the following command as root: 

opcontrol — separate=<choice> 

<choice> can be one of the following: 

• none — do not separate the profiles (default) 

• library — generate per-application profiles for libraries 
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• kernel — generate per-application profiles for the kernel and kernel modules 

• ail — generate per-application profiles for libraries and per-application profiles for the kernel 
and kernel modules 

If — separate=iibrary is used, the sample file name includes the name of the executable as 
well as the name of the library. 

3. Starting and Stopping OProfile 

To start monitoring the system with OProfile, execute the following command as root: 

opcontrol — start 

Output similar to the following is displayed: 

Using log file /var /lib/oprof ile/oprof iled . log 
Daemon started. 
Profiler running. 

The settings in /root/ .oprofiie/daemonrc are used. 

The OProfile daemon, oprof iied, is started; it periodically writes the sample data to the 

/var/iib/oprof iie/sampies/ directory. The log file for the daemon is located at 

/var/ lib/ oprof ile/oprof iled . log. 

To stop the profiler, execute the following command as root: 

opcontrol — shutdown 

4. Saving Data 

Sometimes it is useful to save samples at a specific time. For example, when profiling an 
executable, it may be useful to gather different samples based on different input data sets. If the 
number of events to be monitored exceeds the number of counters available for the processor, 
multiple runs of OProfile can be used to collect data, saving the sample data to different files 
each time. 

To save the current set of sample files, execute the following command, replacing <name> with a 
unique descriptive name for the current session. 

opcontrol — save=<name> 
The directory /var/lib/oprof ile/ samples/ name I is created and the current sample files are 
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copied to it. 

5. Analyzing the Data 

Periodically, the OProfile daemon, oprof iied, collects the samples and writes them to the 
/var/iib/oprof iie/sampies/ directory. Before reading the data, make sure all data has been 
written to this directory by executing the following command as root: 

opcontrol — dump 



Each sample file name is based on the name of the executable. For example, the samples for 
the default event on a Pentium III processor for /bin/bash becomes: 

\ {root \ } /bin/bash/ \ {dep\ } A {rootA } /bin/bash/ CPU_CLK_UNHALTED .100000 

The following tools are available to profile the sample data once it has been collected: 

• opreport 

• opannotate 

Use these tools, along with the binaries profiled, to generate reports that can be further 
analyzed. 



A 



Warning 

The executable being profiled must be used with these tools to analyze the data. 
If it must change after the data is collected, backup the executable used to create 
the samples as well as the sample files. 



Samples for each executable are written to a single sample file. Samples from each dynamically 
linked library are also written to a single sample file. While OProfile is running, if the executable 
being monitored changes and a sample file for the executable exists, the existing sample file is 
automatically deleted. Thus, if the existing sample file is needed, it must be backed up, along 
with the executable used to create it before replacing the executable with a new version. Refer 
to Section 4, "Saving Dafa"for details on how to backup the sample file. 

5.1. USing opreport 

The opreport tool provides an overview of all the executables being profiled. 
The following is part of an example output: 
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Profiling 


through 
TIMER: I 


timer interrupt 




samples | 




% 1 






25926 


97 . 


,5212 


no-vmlinux 




359 


1 . 


.3504 


pi 




65 


. 


, 2445 


Xorg 




62 


. 


. 2332 


libvte . so . 4 . 4 . 




56 


. 


. 2106 


libc-2 . 3 . 4 . so 




34 


. 


,127 9 


libglib-2 .0. so. 0.400. 7 




19 


. 


, 0715 


libXft.so.2.1.2 




17 


. 


. 0639 


bash 




8 


. 


.0301 


ld-2.3.4.so 




8 


. 


.0301 


libgdk-xll-2 . . so . . 400 . 


, 13 


6 


. 


. 0226 


libgob ject-2 . . so . . 400 . 


, 7 


5 


. 


.0188 


oprof iled 




4 


, 


. 0150 


libpthread-2 . 3 . 4 . so 




4 


, 


. 0150 


libgtk-xll-2 .0. so. 0.400. 


,13 


3 


, 


. 0113 


libXrender . so .1.2.2 




3 


, 


. 0113 


du 




1 


, 


. 0038 


libcrypto . so . . 9 . 7a 




1 


. 


. 0038 


libpam . so . . 7 7 




1 


. 


. 0038 


libtermcap . so . 2 . . 8 




1 


. 


. 0038 


libXll.so.6.2 




1 


. 


. 0038 


libgthread-2 . . so . . 400 . 


, 7 


1 


. 


. 0038 


libwnck-1 . so . 4 . 9 . 





Each executable is listed on its own line. The first column is the number of samples recorded for 
the executable. The second column is the percentage of samples relative to the total number of 
samples. The third column is the name of the executable. 

Refer to the opreport man page for a list of available command line options, such as the -r 
option used to sort the output from the executable with the smallest number of samples to the 
one with the largest number of samples. 

5.2. Using o P re P ort on a Single Executable 

To retrieve more detailed profiled information about a specific executable, use opreport: 

opreport <mode><executable> 

<executabie> must be the full path to the executable to be analyzed. <mode> must be one of 
the following: 



-l 

List sample data by symbols. For example, the following is part of the output from running 

the Command opreport -1 /lib/tls/libc-<versio.n>. so: 
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samples 


% 






symbol name 


12 


21 . 


.42 


86 


gconv_transf orm_ut f 8_internal 


5 


8 . 


. 92 


86 


_int_malloc 


4 


7 . 


. 1429 


malloc 


3 


5 . 


.3571 


i 68 6 . get_pc_thunk . bx 


3 


5 . 


.3571 


_dl_mcount_wrapper_check 


3 


5 . 


.3571 


mbrtowc 


3 


5 . 


.3571 


memcpy 


2 


3 . 


. 5714 


_int_realloc 


2 


3 . 


. 5714 


_n l_i n t e r n_l o c a 1 e_da t a 


2 


3 . 


. 5714 


free 


2 


3 . 


. 5714 


strcmp 


1 


1 . 


.78 


57 


ctype_get_mb_cur_max 


1 


1 . 


.78 


57 


unregister_at f ork 


1 


1 . 


.78 


57 


write_nocancel 


1 


1 . 


.78 


57 


_dl_addr 


1 


1 . 


.78 


57 


_int_f ree 


1 


1 . 


.78 


57 


_itoa_word 


1 


1 . 


.78 


57 


calc_eclosure_iter 


1 


1 . 


.78 


57 


fopen@@GLIBC_2 . 1 


1 


1 . 


.78 


57 


getpid 


1 


1 . 


.78 


57 


memmove 


1 


1 . 


.78 


57 


msort_with_tmp 


1 


1 . 


.78 


57 


strcpy 


1 


1 . 


.78 


57 


strlen 


1 


1 . 


.78 


57 


vfprintf 


1 


1 . 


.78 


57 


write 



The first column is the number of samples for the symbol, the second column is the 
percentage of samples for this symbol relative to the overall samples for the executable, 
and the third column is the symbol name. 

To sort the output from the largest number of samples to the smallest (reverse order), use 
-r in conjunction with the -1 option. 

-i <symbol-name> 

List sample data specific to a symbol name. For example, the following output is from the 

Command opreport -1 -i gconv_transf orm_utf 8_internal 

/lib/tls/ libc-<version> . so! 

samples % symbol name 

12 100.000 gconv_transf orm_utf 8_internal 

The first line is a summary for the symbol/executable combination. 

The first column is the number of samples for the memory symbol. The second column is 
the percentage of samples for the memory address relative to the total number of samples 
for the symbol. The third column is the symbol name. 
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List sample data by symbols with more detail than -1. For example, the following output is 

from the Command opreport -1 -d gconv_transform_utf 8_internal 

/lib/tls/ libc-<version> . so! 



vma 




samples 




00a9S 


3 64 


12 


100.000 


00a9S 


S640 


1 


8.3333 


00a9S 


!68c 


2 


16. 6667 


00a9S 


!69a 


1 


8.3333 


00a9S 


S6cl 


1 


8.3333 


00a9S 


S720 


1 


8.3333 


00a9S 


S749 


1 


8.3333 


00a9S 


S753 


1 


8.3333 


00a9S 


S789 


1 


8.3333 


00a9S 


3864 


1 


8.3333 


00a9i 


!869 


1 


8.3333 


00a98b08 


1 


8.3333 



symbol name 

gconv_t ransf orm_ut f 8_internal 



The data is the same as the -l option except that for each symbol, each virtual memory 
address used is shown. For each virtual memory address, the number of samples and 
percentage of samples relative to the number of samples for the symbol is displayed. 

-x < symbol -name> 

Exclude the comma-separated list of symbols from the output. 

session!<narae> 

Specify the full path to the session or a directory relative to the 

/var/lib/oprof ile/ samples / directory. 

5.3. Using opannotate 

The opannotate tool tries to match the samples for particular instructions to the corresponding 
lines in the source code. The resulting files generated should have the samples for the lines at 
the left. It also puts in a comment at the beginning of each function listing the total samples for 
the function. 

For this utility to work, the executable must be compiled with GCC's -g option. By default, Red 
Hat Enterprise Linux packages are not compiled with this option. 

The general syntax for opannotate is as follows: 

opannotate — search-dirs <src-dir> — source <executable> 



The directory containing the source code and the executable to be analyzed must be specified. 
Refer to the opannotate man page for a list of additional command line options. 
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6. Understanding / dev/ oprof iie/ 

The /dev/oprof iie/ directory contains the file system for OProfile. Use the cat command to 
display the values of the virtual files in this file system. For example, the following command 
displays the type of processor OProfile detected: 

cat /dev/oprof ile/cpu_type 

A directory exists in /dev/oprof iie/ for each counter. For example, if there are 2 counters, the 
directories /dev/oprof iie/o/ and dev/oprof iie/i/ exist. 

Each directory for a counter contains the following files: 

• count — The interval between samples. 

• enabled — If 0, the counter is off and no samples are collected for it; if 1 , the counter is on 
and samples are being collected for it. 

• event — The event to monitor. 

• kernel — If 0, samples are not collected for this counter event when the processor is in 
kernel-space; if 1 , samples are collected even if the processor is in kernel-space. 

• unit_mask — Defines which unit masks are enabled for the counter. 

• user — If 0, samples are not collected for the counter event when the processor is in 
user-space; if 1 , samples are collected even if the processor is in user-space. 

The values of these files can be retrieved with the cat command. For example: 

cat /dev/oprof ile/0/count 

7. Example Usage 

While OProfile can be used by developers to analyze application performance, it can also be 
used by system administrators to perform system analysis. For example: 



• Determine which applications and services are used the most on a system — opreport can 
be used to determine how much processor time an application or service uses. If the system 
is used for multiple services but is under performing, the services consuming the most 
processor time can be moved to dedicated systems. 

• Determine processor usage — The cpu_clk_unhalted event can be monitored to determine 
the processor load over a given period of time. This data can then be used to determine if 
additional processors or a faster processor might improve system performance. 
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8. Graphical Interface 

Some OProfile preferences can be set with a graphical interface. To start it, execute the 
oprof_start command as root at a shell prompt. 

After changing any of the options, save them by clicking the Save and quit button. The 
preferences are written to /root/ .oprofiie/daemonrc, and the application exits. Exiting the 
application does not stop OProfile from sampling. 

On the Setup tab, to set events for the processor counters as discussed in Section 2.2, "Setting 
Events to Monitor", select the counter from the pulldown menu and select the event from the list. 
A brief description of the event appears in the text box below the list. Only events available for 
the specific counter and the specific architecture are displayed. The interface also displays 
whether the profiler is running and some brief statistics about it. 
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Setup 



Configuration 



Counter 0: BUS_DRDY_C LOCKS 



Counter settings 
Enabled 



Event 

L2_DBUS_BUSY 
L2_DBUS_BUSY_RD 



BUS_DRDY_CLOCKS 



BUS_LOCK_C LOCKS 

BUS_REQ_OUTSTANDI NG 

BUS_TRAN_BRD 

BUS_TRAN_RFO 

BUS_TRANS_WB 

BUS_TRAN_I FETCH 

BUS_TRAN_I NVAL 

BUS_TRAN_PWR 

BUS_TRANS_P 

BUS_TRANS_IO 

BUS_TRANS_DEF 

BUS_TRAN_BURST 

BUS_TRAN_ANY 

BUS_TRAN_MEM 

BUS_DATA_RCV 

BUS_BNR_DRV 

BUS_HIT_DRV 

BUS_HITM_DRV 

BUS_SNOOP_5TALL 

COMP_FLOP_RET 

FLOPS 

CYCLES_DIV_BUSY 

LD_BLOCKS 

SB_DRAINS 

MISALIGN_MEM_REF 

EMON_KNI_PREF_DI SPATCHED 

FMON KNI PRFF MISS 



\7\ Profile kernel 

[7] Profile user binaries 

Count 397952 



Unit mask 

□ self-generated transactions 
any transactions 



| bus cycles this processor is driving HIT pin 



Profiler running hours, 59 mins (29 interrupts / second, total 49471) 



Start profile 



Flush profiler data 



Stop profiler 



Save and £uit 
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Figure 40.1. OProfile Setup 

On the right side of the tab, select the Profile kernel option to count events in kernel mode for 
the currently selected event, as discussed in Section 2.3, "Separating Kernel and User-space 
Profiles". If this option is unselected, no samples are collected for the kernel. 

Select the Profile user binaries option to count events in user mode for the currently selected 
event, as discussed in Section 2.3, "Separating Kernel and User-space Profiles". If this option is 
unselected, no samples are collected for user applications. 

Use the Count text field to set the sampling rate for the currently selected event as discussed in 
Section 2.2. 1, "Sampling Rate". 

If any unit masks are available for the currently selected event, as discussed in Section 2.2.2, 
"Unit Masks", they are displayed in the Unit Masks area on the right side of the Setup tab. 
Select the checkbox beside the unit mask to enable it for the event. 

On the Configuration tab, to profile the kernel, enter the name and location of the vmlinux file 
for the kernel to monitor in the Kernel image file text field. To configure OProfile not to monitor 
the kernel, select No kernel image. 
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Setup Configuration 



Kernel image file /boot/v m I i n ux-2 .4.2 1-1 . 1 93 1 .2 . 349.2 . 2 .ents m p | [77] □ No kernel image 



□ Verbose 

□ Per-application kernel samples files 

□ Per-application shared libs samples files 



Profiler running 1 hours, 44 mins (32 interrupts / second, total 176226) 



Start profiler 



Flush profiler data 



Stop profiler 



i Save and guitj 



Figure 40.2. OProfile Configuration 



If the Verbose option is selected, the oprof iied daemon log includes more information. 
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If Per-application kernel samples files is selected, OProfile generates per-application profiles 
for the kernel and kernel modules as discussed in Section 2.3, "Separating Kernel and 
User-space Profiles". This is equivalent to the opcontroi — separate=kernei command. If 
Per-application shared libs samples files is selected, OProfile generates per-application 

profiles for libraries. This is equivalent to the opcontroi — separate=iibrary command. 

To force data to be written to samples files as discussed in Section 5, "Analyzing the Data", click 
the Flush profiler data button. This is equivalent to the opcontroi —dump command. 

To start OProfile from the graphical interface, click Start profiler. To stop the profiler, click Stop 
profiler. Exiting the application does not stop OProfile from sampling. 

9. Additional Resources 

This chapter only highlights OProfile and how to configure and use it. To learn more, refer to the 
following resources. 

9.1. Installed Docs 

• /usr/share/doc/oprof ile-<version>/oprof ile . html — OProfile Manual 

• oprof ile man page — Discusses opcontroi, opreport, opannotate, and op_help 

9.2. Useful Websites 

http://oprofile.sourceforge.net/ — Contains the latest documentation, mailing lists, IRC channels, 
and more. 
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